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个 容错 过 的 成 长 之 旅 


受 父亲 有 影响，5 岁 的 埃 里 克 ' 马 瑟 斯 开始 编写 自己 的 第 一 个 程序 个 简单 的 猜 数 字 游 戏 。 
从 孩童 时 期 开始 ， 编 程 带 给 马 瑟 斯 的 满足 感 一 直 影 响 至 今 。30 岁 时 ， 作 为 Python 爱好 者 ， 他 开 
始 在 技术 社区 中 义务 教授 Python。 源 于 对 Python 的 好 奇 心 ， 他 的 儿子 Ever 每 天 不 断 提 问 ， 这 才 
驱使 他 有 了 写作 本 书 的 想法 。 所 以 , 与 其 说 它 是 一 本 书 , 倒 不 如 说 它 是 对 父子 两 代 人 编程 初 心 的 
传承 。 

英文 书 名 进一步 阐述 了 本 书 的 意图 , Python Crash Course: A Hands-On, Project-Based Introduction 
to Programming 直译 过 来 的 意思 是 “Python 速成 教程 :动手 操作 、 基 于 项 目的 编程 入 门 ”。 从 书 
名 来 看 , 它 并 不 是 真正 意义 上 的 教材 。 与 大 学 计算 机 系 的 正统 编程 语言 教材 相 比 , 它 最 大 的 不 同 
点 在 于 : 


口 实践 为 主 (hands-on ) 
口 项 目 为 纲 ( project-based ) 


如 今 ， 随 着 互联 网 产业 的 高 速 发 展 ， 在 网 络 上 早已 积累 了 极其 丰富 的 Python 学 习 资料 ， 任 
何人 都 可 以 基于 这 些 资源 ,自学 掌握 Python。 但 实际 上 ,网 络 上 充斥 的 资源 太 多 、 太 杂 且 不 成 体 
系 ， 在 没有 足够 的 编程 /工程 经 验 之 前 ， 仅 靠 “ 看 ” 线 上 资源 自学 ， 的 确 是 一 件 非常 困难 的 事 。 


当年 , 大妈 自己 光 是 开发 第 一 个 实用 工具 ( 一 个 不 超过 50 行 代码 的 项 目 ), 就 前 后 用 了 将 近 
半年 的 时 间 才 得 以 成 功 。 之 所 以 耗 时 这 么 久 ， 原 因 在 于 : 


口 官方 文档 /教程 过 大 、 过 全 ， 学 习 曲 线 陡 峭 ， 更 适合 有 经 验 的 软件 工程 师 ; 
口 面向 初学 者 的 教程 只 讲 基础 语法 ， 并 没有 关于 项 目的 实践 引导 。 

20 多 年 过 去 了 ， 市 面 上 一 直 不 乏 各 种 教授 “ 零 基础 入 门 Python” 的 图 书 ， 但 至 今 只 有 两 本 
摸 到 了 门 径 。 一 本 是 《 笨 办 法 学 Python》， 通 过 极其 精练 的 针对 性 练习 ， 帮 助 小 白 突破 对 编程 的 
恐惧 ， 但 遗 城 的 是 ， 它 并 没有 包含 如 何 完 成 实用 工程 的 内 容 。 另 外 一 本 ， 就 是 这 本 “Python 蜡 
蛇 书 ”。 得 益 于 中 学 老师 的 身份 ， 作 者 平时 接触 的 都 是 非 计 算 机 专业 的 学 生 。 他 结合 自己 的 教学 
经 历 ， 扎 写 了 这 本 从 零 开 始 快速 上 手 Python 的 好 书 。 更 令 人 兴奋 的 是 ， 为 了 拥抱 Python 技术 生 
态 的 变化 ， 作 者 及 时 增补 了 第 2 版 ， 蔡 换 和 追加 了 很 多 常用 模块 /框架 /工具 的 介绍 ， 整 体 上 更 贴 
近 实 际 开发 环境 。 不过， 从 大 妈 的 经 验 来 看 ， 完 全 无 基础 的 读者 最 好 别 从 第 1 章 开 始 学 习 ， 否则 
在 第 一 部 分 就 会 耗 尽 所 有 热情 。 


iv 不 容错 过 的 成 长 之 旅 


这 里 ， 我 建议 大 家 : 
口 第 一 部 分 尽 可 能 在 和 2 小 时 内 快速 浏览 一 这 ， 不 用 理解 ， 先 混 个 眼熟 ; 
口 第 二 部 分 跟着 项 目 实践 精读 ， 对 应 查阅 第 一 部 分 的 基础 知识 点 ， 针 对 性 地 自我 答疑 。 
这 样 ， 你 就 能 从 枯燥 的 语法 、 控 制 结构 、 数 据 结构 等 无 穷 的 编程 概念 中 挣脱 出 来 ， 进 入 一 个 
个 具体 真实 的 项 目 场景 中 ,一 切 将 变 得 异常 清晰 、 有 目标 且 可 检验 。 当 然 ， 最 好 还 是 能 找到 一 起 
学 习 的 小 伙伴 , 无论 是 线 下 共 读 ,还 是 线 上 远程 协同 。 总 之 ,大 家 一 起 折腾 ， 阅读 和 学 习 才 可 能 
事半功倍 。 

最 后 ， 我 想 说 ，Python 是 否 值得 学 ， 已 经 不 再 是 值得 怀疑 的 问题 了 (特别 是 在 人 类 于 2018 年 
用 Python 合成 首 张 黑洞 照片 之 后 )。 但 是 ， 如 何 能 高 效 学 会 Python， 永 远 是 个 值得 思考 的 重要 
问题 。 


这 个 问题 的 答案 ， 是 绕 不 开本 书 的 。 


NR wR 


大 妈 /ZoomQuiet，CPyUG 联合 创始 人 、 蟒 营 " 创 始 人 


第 1 版 赞誉 


“No Starch Press 音 故 易 新 ,不断 推 出 堪 与 传统 编程 图 书 比 肩 的 未 来 经 典 ， 而 本 书 就 是 其 中 
之 一 。” 
一 一 Greg Laden, ScienceBlogs 


“对 复杂 的 项 目 妮 妮 道 来 ， 逻 辑 合 理 、 赏 心 避 目 ， 令 人 欲罢不能 。 


Fall Circle 杂志 


“清晰 地 阐述 代码 片段 ， 引 领 你 每 次 前 进 一 小 步 ， 逐 步 编写 出 复杂 的 代码 ， 并 对 其 中 的 原理 
了 如 指 掌 。” 


FlickThrough Reviews 


“美妙 的 Python 学 习 体 验 ，Python 新 手 的 不 二 选择 。” 


Mikke Goes Coding 


l 


副 其 实 ， 出 色 地 完成 了 引领 读者 从 人 门 到 实践 的 任务 。 三 个 项 目 既 富有 挑战 性 又 寅 教 于 
乐 ， 还 有 大 量 极 具 帮助 的 练习 题 。 


RealPython 网 站 


“简明 而 全 面 的 Python 编程 入 门 读物 ， 助 你 最 终 掌 握 Python ， 是 一 本 值得 拥有 的 杰出 作品 。 
TutorialEdge 网 站 


“编程 小 白 的 明智 之 选 。 化 繁 为 简 ,一 步 一 个 脚印 地 带领 你 进入 Python 这 门 深奥 语言 的 山 膏 。” 
一 一 WhatPixel 网 站 


“面面俱到 ， 初 学 者 需要 知道 的 Python 知识 应 有 尺 有 。” 


Firebear Studio GmbH 


说 以 此 书 献 给 我 的 父亲 和 儿子 。 
感谢 父亲 抽出 时 间 回 答 我 提出 的 每 个 编程 问题 ， 感 谢 儿 子 Ever 开始 向 我 提问 了 。 


ll 


前 


本 书 第 1 版 出 版 后 反响 强烈 ,被 翻译 成 了 8 种 语言 。 我 收 到 了 众多 读者 的 来 信和 电子 邮件 ， 
有 小 到 10 岁 的 孩童 ， 还 有 利用 闲暇 学 习 编程 的 退休 人 员 。 有 一 些 初中 、 高 中 和 大 学 用 其 作为 教 
材 , 有 使 用 高 级 教材 的 学 生 将 其 作为 补充 材料 , 还 有 人 通过 阅读 它 来 提高 工作 技能 或 开发 自己 的 
项 目 。 总 而 言 之 ， 第 1 版 的 广泛 用 途 完 全 符合 我 最 初 的 预期 。 


第 2 版 的 编写 过 程 从 始 至 终 都 令 人 愉悦 。Python 虽 是 一 门 成 熟 的 语言 ， 但 也 像 其 他 语言 一 
样 在 不 断 发 展 。 我 对 本 书 的 修订 目标 是 更 精练 、 更 简单 易 懂 。 现 在 已 经 没有 任何 理由 再 学习 
Python 2 了， 因此 第 2 版 只 介绍 Python 3。 很 多 Python 包 安 装 起 来 比 以 前 容易 ， 因 此 安装 说 明 也 
更 加 简明 。 我 新 增 了 一 些 会 对 读者 有 帮助 的 主题 ; 更 新 了 部 分 音节， 以 反映 如 何 利 用 Python 中 
的 新 方式 更 简单 地 完成 任务 ; 澄清 了 第 1 版 中 对 Python 语言 的 某 些 细节 描述 得 不 太 准 确 的 地 方 。 
所 有 项 目 都 做 了 全 面 修订 , 采用 得 到 良好 维护 的 流行 库 , 让 你 能 够 充满 信心 地 用 它们 来 开发 自己 的 
项 目 。 


下 面 概述 一 下 第 2 版 所 做 的 具体 修订 。 


口 第 1 章 简化 了 Python 安装 流程 ， 适 用 于 所 有 主流 操作 系统 。 现 在 我 推荐 使 用 文本 编辑 器 

Sublime Text， 它 深 受 初学 者 和 专业 程序 员 的 欢迎 ， 在 各 种 操作 系统 上 都 能 很 好 地 运行 。 

口 第 2 章 更 准确 地 描述 了 Python 变量 的 实现 方式 。 将 变量 描述 为 指向 值 的 标签 ， 让 读者 能 
够 更 好 地 理解 Python 变量 的 行为 。 本 书 使 用 Python 3.6 引 入 的 f 字 符 串 , 该 方法 使 得 在 字 
符 串 中 使 用 变量 值 简单 许多 。Python 3.6 还 引入 了 使 用 下 划 线 来 表示 大 数 的 方式 (如 
1_000_000 )。 第 1 版 把 对 多 变量 赋值 的 介绍 放 在 一 个 项 目 中 , 而 第 2 版 则 将 其 推广 并 移 到 
了 第 2 章 ， 旨 在 惠及 所 有 读者 。 最 后 ， 这 一 章 介 绍 了 Python 里 一 种 清晰 的 常量 表示 法 。 

口 第 6 章 新 增 了 介绍 方法 get() 的 内 容 。get() 从 字典 中 获取 值 ， 并 在 指定 的 键 不 存在 时 返 

回 默认 值 。 

口 第 12 章 ~ 第 14 章 的 “外 星人 入 侵 ” 项 目 现在 完全 是 基于 类 的 。 游 戏 本 身 也 是 类 ,不 再 是 
一 系列 函数 。 这 极 大 地 简化 了 游戏 的 总 体 结构 ， 大 大 地 减少 了 函数 调用 和 必须 提供 的 参 
数 。 阅 读 过 第 1 版 的 读者 一 定 会 对 这 样 的 简化 欣赏 有 加 。 对 于 所 有 操作 系统 ， 现 在 都 只 
需 一 个 命令 就 能 安装 Pygame。 此 外 , 运行 该 游戏 时 , 可 在 全 屏 模 式 和 窗口 模式 之 间 选 择 。 

口 数据 可 视 化 项 目 中 的 Matplotlib 安装 方法 简化 了 , 无 论 读 者 使 用 的 是 哪 种 操作 系统 。 使 用 

Matplotlib 的 可 视 化 调用 的 是 函数 subplots() ， 让 项 目 扩展 起 来 更 容易 。 


一 让 


前 言 vii 


口 第 15 章 的 撕 贷 子 项 目 使 用 了 Plotly。 这 个 可 视 化 库 得 到 了 妥善 的 维护 ， 语 法 清晰 美观 ， 

支持 对 输出 进行 全 面 定制 。 

口 第 16 章 的 天 气 项 目 使 用 了 来 自 美国 国家 海洋 与 大 气管 理 局 的 数据 。 

D 第 17 章 不 再 使 用 Pygal 来 可 视 化 GitHub 的 Python 开源 项 目 ， 转 而 使 用 Plotly。 

口 第 18 章 ~ 第 20 章 使 用 新 版 的 Django 创建 “学 习 笔 记 ” 项目， 并 使 用 新 版 Bootstrap 设置 
样式 。 使 用 django-heroku 简化 了 将 项 目 部 署 到 Heroku 的 流程 ,并 且 转 而 使 用 环境 变量 ， 
而 非 修改 文件 settings.py。 这 种 方法 更 简单 ， 更 接近 专业 程序 员 部 署 Django 项 目的 方法 。 

口 附录 A 做 了 全 面 修订 ,推荐 读者 采用 最 佳 的 Python 安 装 方法 ,附录 B 提 供 了 详尽 的 Sublime 

Text 安装 说 明 ， 并 简要 介绍 了 大 部 分 主流 文本 编辑 器 和 IDE。 附 录 C 引 导读 者 访问 更 新 、 

更 流行 的 在 线 资源 以 寻求 帮助 。 附 录 D 提供 了 Git 版 本 控制 的 简明 教程 。 


感谢 购买 和 阅读 本 书 ! 如 果 有 任何 反馈 或 问题 ， 请 务必 与 我 联系 。 


致谢 


如 果 没 有 No Starch Press 出 色 专 业 人 士 的 帮助 , 本 书 根 本 不 可 能 付 梓 。 是 Bill Pollock 邀请 我 
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加 
条 


如 何 学 习 编 写 第 一 个 程序 , 每 个 程序 员 都 有 不 同 的 故事 。 我 还 是 个 孩子 时 就 开始 学 习 编 程 了 ， 
当时 我 父亲 在 计算 时 代 的 先锋 之 一 数字 设备 公司 (Digital Equipment Corporation ) 工作 。 我 
使 用 一 台 人 简陋 的 计算 机 编写 了 第 一 个 程序 , 这 台 计 算 机 是 父亲 在 家 里 的 地 下 室 组 装 而 成 的 , 它 没 
有 机 箱 , 裸露 的 主板 与 键盘 相连 ,显示 器 是 裸露 的 阴极 射线 管 。 我 编写 的 这 个 程序 是 一 款 简单 的 
猜 数 字 游 戏 ， 其 输出 类 似 于 下 面 这 样 : 


I'm thinking of a number! Try to guess the number Im thinking of: 25 
Too low! Guess again: 50 

Too high! Guess again: 42 

That's it! Would you like to play again? (yes/no) no 

Thanks for playing! 


看 到 家 人 玩 着 我 编写 的 游戏 , 而 且 它 完全 按 我 预期 的 方式 运行 , 我 心里 不 知 有 多 满足 。 此 情 
此 景 我 永远 也 忘 不 了 。 

儿童 时 期 的 这 种 体验 一 直 影 响 我 至 今 。 现 在 , 每 当 我 通过 编写 程序 解决 了 一 个 问题 时 , 心里 
都 会 感到 非常 满足 。 相 比 于 年 少时 , 我 现在 编写 的 软件 满足 了 更 大 的 需求 , 但 通过 编写 程序 获得 
的 满足 感 几 乎 与 从 前 一 样 。 


读者 对 象 


本 书 旨 在 让 你 尽快 学 会 Python, 以 便 编 写 出 能 正确 运行 的 程序 一 一 游戏 、 数 据 可 视 化 和 Web 
应 用 程序 ， 同 时 掌握 让 你 终身 受益 的 基本 编程 知识 。 本 书 适 合 任何 年 龄 的 读者 阅读 ， 它 不 要 求 你 
有 Python 编程 经 验 ， 甚 至 不 要 求 你 有 编程 经 验 。 如 果 你 想 快速 掌握 基本 的 编程 知识 以 便 专 注 于 
开发 感 兴趣 的 项 目 , 并 想 通 过 解决 有 意义 的 问题 来 检查 你 对 新 学 概念 的 理解 程度 , 那么 本 书 就 是 
为 你 编写 的 。 本 书 可 供 初中 和 高 中 教师 用 来 通过 开发 项 目 向 学 生 介绍 编程 。 如 果 你 是 刚 开 始 学 习 
Python 的 大 学 生 ， 觉 得 指定 的 教材 不 那么 容易 理解 ， 那 么 阅读 本 书 将 让 学 习 过 程 变 得 更 轻松 。 


本 书 内 容 
本 书 旨 在 让 你 成 为 优秀 的 程序 员 ， 具 体 地 说 ， 是 优秀 的 Python 程序 员 。 通 过 阅读 本 书 ， 你 


将 迅速 掌握 编程 概念 ， 打 下 坚实 的 基础 ， 并 养 成 良好 的 习惯 。 阅 读本 书后 ， 你 就 可 以 开始 学 习 
Python 高 级 技术 ， 并 能 够 更 轻松 地 掌握 其 他 编程 语言 。 


在 本 书 的 第 一 部 分 ， 你 将 学 习 编 写 Python 程序 时 需要 熟悉 的 基本 编程 概念 ， 你 刚 接触 几乎 
任何 编程 语言 时 都 需要 学 习 这 些 概 念 。 你 将 学 习 各 种 数据 以 及 在 程序 中 将 数据 存储 到 列表 和 字典 
中 的 方式 。 你 将 学 习 如 何 创建 数据 集 以 及 如 何 高 效 地 遍历 它们 。 你 将 学 习 使 用 while 和 if 语句 
来 检查 条 件 , 并 在 条 件 满足 时 执行 代码 的 一 部 分 , 而 在 条 件 不 满足 时 执行 代码 的 男 一 部 分 一 一 这 
可 为 自动 完成 处 理 提 供 极 大 的 帮助 。 

你 将 学 习 获取 用 户 输入 ,让 程序 能 够 与 用 户 交 互 ， 并 在 用 户 没 停止 输入 时 保持 运行 状态 。 你 
将 探索 如 何 编写 函数 来 让 程序 的 各 个 部 分 可 重用 , 这 样 你 编写 执行 特定 任务 的 代码 后 , 想 使 用 它 
多 少 次 都 可 以 。 然 后 ， 你 将 学 习 使 用 类 来 扩展 这 种 概念 以 实现 更 复杂 的 行为 ,从 而 让 非常 简单 的 
程序 也 能 处 理 各 种 不 同 的 情形 。 你 将 学 习 编 写 妥 善 处 理 常见 错误 的 程序 。 学 习 这 些 基本 概念 后 ， 
你 就 能 编写 一 些 简短 的 程序 来 解决 一 些 明 确 的 问题 。 最 后 ， 你 将 向 中 级 编程 迈 出 第 一 步 ， 学习 如 
何 为 代码 编写 测试 ， 以 便 在 进一步 改进 程序 时 不 用 担心 可 能 引入 bug。 第 一 部 分 介绍 的 知识 让 你 
能 够 开发 更 大 、 更 复杂 的 项 目 。 


在 第 二 部 分 , 你 将 利用 在 第 一 部 分 学 到 的 知识 来 开发 三 个 项 目 。 你 可 以 根据 自己 的 情况 ,以 
最 合适 的 顺序 完成 这 些 项 目 ; 你 也 可 以 选择 只 完成 其 中 的 某 些 项 目 。 在 第 一 个 项 目 (第 12 章 ~ 
第 14 章 ) 中 ,你 将 创建 一 个 类 似 于 《太空 人 侵 者 》 的 射击 游戏 ， 这 个 游戏 名 为 《外 星人 入 侵 》， 
它 包 含 多 个 难度 不 断 增加 的 等 级 。 完 成 这 个 项 目 后 ， 你 就 完全 能 够 自己 动手 开发 2D 游戏 了 。 

第 二 个 项 目 (第 15 章 ~ 第 17 章 ) 介绍 数据 可 视 化 。 数 据 科 学 家 的 目标 是 通过 各 种 可 视 化 技 
术 来 搞 懂 海 量 信 息 。 你 将 使 用 通过 代码 生成 的 数据 集 、 已 经 从 网 络 下 载 下 来 的 数据 集 以 及 程序 自 
动 下 载 的 数据 集 。 完 成 这 个 项 目 后 , 你 将 编写 出 能 对 大 型 数据 集 进行 第 选 的 程序 ,并 以 可 视 化 方 
式 将 筛选 出 来 的 数据 呈现 出 来 。 

在 第 三 个 项 目 (第 18 章 ~ 第 20 章 ) 中 , 你 将 创建 一 个 名 为 “学 习 笔 记 ” 的 小 型 Web 应 用 程 
序 。 这 个 项 目 能 够 让 用 户 将 学 到 的 与 特定 主题 相关 的 概念 记录 下 来 。 你 将 能 够 分 别 记录 不 同 的 主 
题 , 还 可 以 让 其 他 人 建立 账户 并 开始 记录 自己 的 学 习 笔 记 。 你 还 将 学 习 如 何 部 署 这 个 项 目 , 让 任 
何人 都 能 够 通过 网 络 访问 它 ， 而 不 管 他 身 处 何方 。 


在 线 资源 
要 获取 以 下 补充 材料 ， 可 访问 ituring.cn/book/2784。 
口 安装 说 明 : 与 书 中 的 安装 说 明 相 同 ， 但 可 直接 点 击 其 中 的 链接 ， 无 须 动手 输入 。 遇 到 安 
装 问题 时 ， 可 参阅 这 些 材料 。 
口 更 新 : 与 其 他 编程 语言 一 样 ，Python 也 是 在 不 断 发 展 变化 的 。 我 提供 了 详尽 的 更 新 记录 ， 
每 当 遇 到 问题 时 ， 你 都 可 参阅 它 看 看 是 否 需要 调整 操作 。 


x 号 读 


口 练习 答案 : 你 应 该 花 大 量 时 间 独 立 完成 “动手 试 一 试 ”中 的 练习 ， 但 如 果 卡 过 了 、 无 法 
取得 进展 ， 可 在 线 查 看 部 分 练习 的 答案 。 
口 速 查 表 : 在 线 提供 了 完整 的 速 查 表 ， 可 作为 主要 概念 的 参考 指南 。 


为 何 使 用 Python 


继续 使 用 Python, 还 是 转 而 使 用 其 他 语言 一 一 也 许 是 编程 领域 较 新 的 语言 ”我 每 年 都 会 考虑 
这 个 问题 。 可 我 依然 专注 于 Python， 其 中 的 原因 很 多 。Python 是 一 种 效率 极 高 的 语言 : 相 比 于 众 
多 其 他 的 语言 ， 使 用 Python 编写 时 ， 程 序 包 含 的 代码 行 更 少 。Python 的 语法 也 有 助 于 创建 整洁 
的 代码 : 相 比 于 使 用 其 他 语言 ， 使 用 Python 编写 的 代码 更 容易 阅读 、 调 试 和 扩展 。 


大 家 将 Python 用 于 众多 方面 : 编写 游戏 、 创 建 Web 应 用 程序 、 解 决 商业 问题 以 及 供 各 类 有 
趣 的 公司 开发 内 部 工具 。Python 还 在 科学 领域 被 大 量 用 于 学 术 研 究 和 应 用 研究 。 


我 依然 使 用 Python 的 一 个 最 重要 的 原因 是 ，Python 社区 有 形形色色 充满 激情 的 人 。 对 程序 
员 来 说 , 社区 非常 重要 ， 因 为 编程 绝 非 孤 独 的 修行 。 大 多 数 程序 员 需 要 向 解决 过 类 似 问题 的 人 寻 
求 建议 ,经验 最 为 丰富 的 程序 员 也 不 例外 。 需 要 有 人 帮助 解决 问题 时 ， 有 一 个 联系 紧密 、 互 帮 互 
助 的 社区 至 关 重 要 ， 而 对 于 像 你 一 样 将 Python 作为 第 一 门 语言 来 学 习 的 人 而 言 ，Python 社区 无 
疑 是 坚强 的 后 盾 。 


Python 是 一 门 出 色 的 语言 ， 值 得 你 去 学 习 。 现 在 就 开始 吧 ! 


电子 书 
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基础 知识 


本 书 的 第 一 部 分 介绍 编写 Python 程序 所 需要 熟悉 的 基本 概念 ， 其 中 很 多 适用 于 所 有 编程 语 
言 ， 因 此 它们 在 你 的 整个 程序 员 生 涯 中 都 很 有 用 。 
第 1 章 介绍 在 计算 机 中 安装 Python， 并 运行 第 一 个 程序 一 一 在 屏幕 上 打印 “Hello Python 
world!”。 

第 2 章 论 述 如 何在 变量 中 存储 信息 以 及 如 何 使 用 文本 和 数字 。 

第 3 章 和 第 4 章 介绍 列表 。 使 用 列表 能 够 在 一 个 变量 中 存储 任意 数量 的 信息 ， 从 而 高 效 地 处 
理 数 据 : 只 需 几 行 代码 ， 你 就 能 够 处 理 数 百 、 数 千 力 至 数 百 万 个 值 。 
第 5 章 讲解 使 用 if 语句 来 编写 这 样 的 代码 : 在 特定 条 件 满足 时 采取 一 种 措施 ， 而 在 该 条 件 
不 满足 时 采取 另 一 种 措施 。 

第 6 章 演示 如 何 使 用 Python 字典 ， 将 不 同 的 信息 关联 起 来 。 与 列表 一 样 ， 你 也 可 以 根据 需 
要 在 字典 中 存储 任意 数量 的 信息 。 

第 7 章 讲 解 如 何 从 用 户 那 里 获取 输入 ， 让 程序 变 成 交互 式 的 。 你 还 将 学 习 while 循环 ， 它 不 
断 地 运行 代码 块 ， 直 到 指定 的 条 件 不 再 满足 为 止 。 

第 8 章 介 绍 编写 函数 ,函数 是 执行 特定 任务 的 被 命名 的 代码 块 ,你 可 以 根据 需要 随时 运行 它 。 
第 9 章 介 绍 类 ， 它 让 你 能 够 模拟 实物 ， 如 小 狗 、 小 猎 、 人 、 汽 车 、 火 箭 等 ， 让 你 的 代码 能 够 
表示 任何 真实 或 抽象 的 东西 。 
第 10 章 介绍 如 何 使 用 文件 ， 以 及 如 何 处 理 错误 以 免 程序 意外 地 骨 泪 。 你 需要 在 程序 关闭 前 
保存 数据 ， 并 在 程序 再 次 运行 时 读 取 它们 。 你 将 学 习 Python 异常 ， 它 们 让 你 能 够 未 雨 绸 缪 ， 从 
而 让 程序 妥善 地 处 理 错 误 。 

第 11 章 讲解 为 代码 编写 测试 ， 以 核实 程序 是 否 像 你 期 望 的 那样 工作 。 这 样 ， 扩 展 程序 时 ， 
你 就 不 用 担心 引入 新 的 bug 了 。 要 想 脱 离 初 级 程序 员 的 阵容 ,跻身 于 中 级 程序 员 的 行列 ， 测试 代 
码 是 你 必须 掌握 的 基本 技能 之 一 。 


在 本 章 中 ， 你 将 运行 自己 的 第 一 个 程序 一 一 hello world.py。 为 
此 ， 你 首先 需要 检查 自己 的 计算 机 是 否 安 装 了 较 新 版 本 的 Python; 
如 果 没 有 ， 就 要 安装 它 。 你 还 要 安装 一 个 文本 编辑 器 ， 用 于 编写 和 运 
行 Python 程序 。 你 输入 Python 代码 时 ， 这 个 文本 编辑 器 能 够 识别 它 
们 并 突出 显示 不 同 的 部 分 ， 让 你 能 够 轻松 地 了 解 代 码 的 结构 。 


1.1 搭建 编程 环境 视 


统计 和 
在 不 同 的 操作 系统 中 ,Python 存在 细微 的 差别 , 因此 有 几 点 你 需要 牢记 在 心 。 本 节 将 确保 你 
的 系统 正确 安装 Python。 


1.1.1 ”Python 版 本 


每 种 编程 语言 都 会 随 着 新 概念 和 新 技术 的 推出 而 不 断 发 展 , Python 开发 者 也 在 一 直人 致力 于 丰 
富 和 强化 其 功能 。 本 书 编写 期 间 的 最 新 版 本 为 Python 3.7， 但 只 要 你 安装 了 Python 3.6 或 更 高 的 版 
本 ， 就 能 运行 本 书 中 的 所 有 代码 。 在 本 节 中 ， 你 将 核实 系统 是 否 安装 了 Python， 以 及 是 否 需 要 安 
装 更 新 的 版 本 。 附录 A 提供 了 详尽 的 指南 , 指导 你 在 各 种 主流 操作 系统 中 安装 最 新 版 本 的 Python 。 

有 些 较 老 的 Python 项 目 依 然 使 用 Python 2， 但 你 应 该 使 用 Python 3。 如 果 你 的 系统 安装 了 


Python 2， 很 可 能 是 为 了 支持 系统 需要 的 一 些 旧 程序 。 你 应 保留 它 ， 并 安装 更 新 的 版 本 以 便 学 习 
本 书 。 


1.1.2 ”运行 Python 代码 片段 


Python 自 带 一 个 在 终端 窗口 中 运行 的 解释 器 ， 让 你 无 须 保存 并 运行 整个 程序 就 能 尝试 运行 


1.2 在 不 同 操作 系统 中 搭建 Python 编程 环境 3 


Python 代码 片段 。 
本 书 将 以 如 下 方式 列 出 代码 片段 : 


@ >>> print("Hello Python interpreter!") 
Hello Python interpreter! 


提示 符 >>> 表 明正 在 使 用 终端 窗口 ， 而 加 粗 的 文本 表示 需要 你 输入 之 后 按 回 车 键 来 执行 的 代 
码 。 本 书 的 大 多 数 示例 是 独立 的 小 程序 , 你 将 在 编辑 器 中 执行 它们 ， 因 为 大 多 数 代 码 也 是 这 样 纺 
写 出 来 的 。 然 而 ， 为 高 效 地 演示 一 些 基 本 概念 ， 需 要 在 Python 终端 会 话 中 执行 一 系列 代码 片段 。 
只 要 代码 清单 中 包含 三 个 右 尖 括 号 ( 如 @ 所 示 )， 就 意味 着 代码 是 在 终端 会 话 中 执行 的 ， 而 输出 
也 是 来 自 终端 会 话 的 。 稍 后 将 演示 如 何在 Python 解释 器 中 编写 代码 。 


此 外 , 你 还 要 安装 一 款 文 本 编辑 器 , 并 使 用 它 来 完成 学 习 编 程 的 标准 操作 一 一 编写 一 个 简单 
的 Hello World 程序 。 长 期 以 来 ， 编 程 界 都 认为 刚 接触 一 门 新 语言 时 ， 如 果 首 先 使 用 它 来 编写 一 
个 在 屏幕 上 显示 消息 “Hello world!” 的 程序 , 将 给 你 带 来 好 运 。 这 种 程序 虽然 简单 , 却 有 其 用 途 : 
如 果 它 能 够 在 你 的 系统 上 正确 运行 ,那么 你 编写 的 任何 Python 程序 也 都 将 正确 运行 。 


1.1.3 Sublime Text 简介 


Sublime Text 是 一 款 简 单 的 文本 编辑 器 ， 可 以 在 任何 现代 操作 系统 中 安装 。 你 几乎 能 直接 在 
Sublime Text 中 执行 所 有 程序 。 在 Sublime Text 中 执行 程序 时 ， 代 码 将 在 其 内 髓 的 终端 会 话 中 运 
行 ， 让 你 能 够 轻松 地 看 到 输出 。 


Sublime Text 是 一 款 适 合 初学 者 的 编辑 器 ， 但 很 多 专业 编程 人 员 也 在 使 用 它 。 在 学 习 Python 
的 过 程 中 熟练 掌握 Sublime Text 之后， 可 继续 使 用 它 来 编写 复杂 的 大 型 项 目 。Sublime Text 的 许 
可 条 件 非 常 宽松 , 可 以 一 直 免 费 使 用 , 但 如 果 你 喜欢 它 并 想 长 期 使 用 ， 其 开发 者 会 要 求 你 购买 许 
可 证 。 


附录 了 介绍 了 其 他 几 种 文本 编辑 器 , 如 果 你 想 知 道 还 有 哪些 编辑 器 可 供 使 用 , 现在 就 应 该 读 
一 读 。 如 果 你 想 马上 动手 编程 ， 可 先 使 用 Sublime Text， 等 有 了 一 些 编程 经 验 后 再 考虑 使 用 其 他 
编辑 器 。 本 章 稍 后 将 引导 你 在 当前 使 用 的 操作 系统 中 安装 Sublime Text。 


1.2 在 不 同 操作 系统 中 搭建 Python 编程 环境 

Python 是 一 种 跨 平台 的 编程 语言 , 这 意味 着 它 能 够 运行 在 所 有 主流 操作 系统 中 。 在 所 有 安装 
了 Python 的 现代 计算 机 上 , 都 能 够 运行 你 编写 的 任何 Python 程序 。 然 而 , 在 不 同 的 操作 系统 中 ， 
安装 Python 的 方法 存在 细微 的 差别 。 

在 本 节 中 ， 你 将 学 习 如 何在 自己 的 系统 中 安装 Python。 首 先 要 检查 系统 是 否 安装 了 较 新 的 
Python 版 本 , 如 果 没 有 , 就 进行 安装 ; 然后 是 安装 Sublime Text。 在 不 同 的 操作 系统 中 搭建 Python 
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编程 环境 时 ， 只 有 这 两 步 存 在 差别 。 


接 下 来 ， 你 将 运行 Hello World 程序 ， 并 排除 各 种 故障 。 我 将 详细 介绍 如 何在 各 种 操作 系统 
中 完成 这 些 任务 ， 让 你 能 够 搭建 一 个 对 初学 者 友好 的 Python 编程 环境 。 


1.2.1 在 Windows 系统 中 搭建 Python 编程 环境 
Windows 系统 并 非 都 默认 安装 了 Python ， 因 此 你 可 能 需要 安装 它 ， 再 安装 Sublime Text。 
1. 安装 Python 


首先 ， 检 查 你 的 系统 是 否 安装 了 Python。 为 此 ， 在 “开始 ”菜单 中 输入 command 并 按 回 车 以 
打开 一 个 命令 窗口 ; 也 可 以 按 住 Shf 刍 并 右 击 桌 面 ,选择 “在 此 处 打开 命令 窗口 ”“。 在 终端 窗口 
中 输入 python ( 全 部 小 写 ) 并 按 回 车 : 如 果 出 现 了 Python 提示 符 (>>> )， 就 说 明 系 统 安装 了 Python; 
如 果 出 现 一 条 错误 消息 ， 指 出 python 是 无 法 识别 的 命令 ， 就 说 明 没 有 安装 Python。 

如 果 出 现 后 一 种 情况 或 者 安装 的 Python 版 本 低 于 3.6 ,就 需要 下 载 Windows Python 安装 程序 。 
为 此 ,请 访问 Python 官方 网 站 主页 。 将 鼠标 指向 Download 链接 ， 你 将 看 到 一 个 用 于 下 载 最 新 版 
本 Python 的 按钮 。 单 击 该 按钮 ， 这 将 根据 你 的 系统 自动 下 载 正确 的 安装 程序 。 下 载 安 装 程序 后 ， 
运行 它 。 请 务必 选中 复 选 框 Add Python ( 版 本 号 ) to PATH ( 例如 图 1-1 )， 这 让 你 能 够 更 轻松 地 
配置 系统 。 


多 python 3.7.2 (64-bib Setup 一 x 


| Install Python 3.7.2 (64-bit) 
Select Install Now to install Python with default settings, or choose 


Customize to enable or disable features. 


一 Install Now 
CNUsers\matthese\AppData\Locaf\Programs\Python\Python37 
Includes IDLE, pip and documentation 


Creates shortcuts and file associations 


一 Customize installation 
Choose location and features 


python 


for 口 Install launcher for all users (recommended) 


windows ha E re | 


图 1-1 确保 选中 复 选 框 Add Python (版 本 号 ) to PATH 


@ 在 Windows 10 系统 中 ， 可 如 此 打开 PowerShell 窗口 。 一 一 编者 注 
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2. 在 终端 会 话 中 运行 Python 


打开 一 个 命令 窗口 ， 并 在 其 中 执行 命令 python。 如 果 出 现 了 Python 提示 符 (>>> )， 就 说 明 
Windows 找到 了 你 刚 安装 的 Python 版 本 。 


C:\> python 

Python 3.7.2 (v3.7.2:9a3ffc0492, Dec 23 2018, 23:09:28) [MSC v.1916 64 bit 
(AMD64)] on win32 

Type "help", "copyright", "credits" or "license" for more information. 

>>> 


注意 ”如果 没有 看 到 类 似 的 输出 ， 请 参阅 附录 A 中 更 详尽 的 安装 说 明 。 


在 Python 会 话 中 执行 下 面 的 命令 ， 并 确认 看 到 了 输出 “Hello Python interpreter!”。 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


每 当 要 运行 Python 代码 片段 时 ， 都 请 打开 一 个 命令 窗口 并 启动 Python 终端 会 话 。 要 关闭 该 
终端 会 话 ， 可 按 Ctrl + Z、 再 按 回 车 键 ， 也 可 执行 命令 exit()。 


om 


3. 安装 Sublime Text 


要 下 载 Sublime Text 安装 程序 ， 可 访问 Sublime Text 网 站 主页 ， 单 击 Download 链接 ， 并 查 
找 Windows 安装 程序 。 下 载 安装 程序 后 运行 它 ， 并 接受 所 有 的 默认 设置 。 


1.2.2 在 macOS 系统 中 搭建 Python 编程 环境 


大 多 数 macOS 系统 默认 安装 了 Python。 确 定安 装 了 Python 后 ， 你 还 需 安装 Sublime Text， 
并 确保 其 配置 正确 无 误 。 


1. 检查 是 否 安装 了 Python 3 


在 文件 夹 Applications/Utilities 中 , 选择 Terminal, 打开 一 个 终端 窗口 ; 也 可 以 按 Command + 
空格 键 ， 再 输入 terminal 并 按 回 车 。 为 确定 是 否 安装 了 Python， 请 执行 命令 python ( 请 注意 ， 


其 中 的 p 是 小 写 的 ) 这 也 将 在 终端 窗口 中 启动 Python， 让 你 能 够 输入 Python 命令 。 输 出 类 似 于 
下 面 这 样 ， 它 指出 了 安装 的 Python 版 本 ; 最 后 的 >>> 是 提示 符 ， 让 你 能 够 输入 Python 命令 。 


$ python 
Python 2.7.15 (default, Aug 17 2018, 22:39:05) 
[GCC 4.2.1 Compatible Apple LLVM 9.1.0 (clang-902.0.39.2)] on darwin 


Type "help", "copyright", "credits", or "license" for more information. 
>>> 
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上 述 输出 表明 ， 当 前 计算 机 默认 使 用 的 Python 版 本 为 Python 2.7.15。 看 到 上 述 输出 后 ,如果 
要 退出 Python 并 返回 到 终端 窗口 ， 可 按 Ctrl + D 或 执行 命令 exit()。 

要 检查 系统 是 否 安装 了 Python 3， 可 尝试 执行 命令 python3。 可 能 会 出 现 一 条 错误 消息 ， 这 
意味 着 没有 安装 任何 Python 3 版 本 。 如 果 输 出 指出 安装 了 Python 3.6 或 更 高 的 版 本 ， 可 以 直接 跳 
过 下 一 小 节 。 如 果 系 统 没 有 安装 Python 3 ,就 需要 手动 安装 它 。 注 意 ,请 将 本 书 中 所 有 的 命令 python 
都 蔡 换 为 命令 python3 ， 这 样 才能 使 用 Python 3 而 不 是 Python 2 )。Python 2 和 Python 3 的 差别 
非常 大 ， 如 果 你 使 用 Python 2 来 运行 本 书 的 代码 ， 肯 定 会 遇 到 麻烦 。 

如 果 系 统 默认 安装 的 是 低 于 Python 3.6 的 版 本 ， 请 按 下 一 小 节 的 说 明 安 装 最 新 版 本 。 


2. 安装 最 新 的 Python 版 本 


要 下 载 Python 安装 程序 ， 可 访问 Python 网 站 主页 。 将 鼠标 指向 Download 链接 ， 你 将 看 到 
一 个 用 于 下 载 最 新 版 本 Python 的 按钮 。 单 击 该 按钮 ， 这 将 根据 你 的 系统 自动 下 载 正 确 的 安装 程 
序 。 下 载 安 装 程序 后 ， 运 行 它 。 


运行 安装 程序 后 ， 在 终端 提示 符 下 执行 如 下 命令 : 


$ python3 --version 
Python 3.7.2 


输出 应 该 类 似 于 上 面 这 样 。 如 果 确 实 如 此 ， 就 可 以 开始 尝试 使 用 Python 了 ， 但 请 务必 将 本 
书 中 的 每 个 命令 python 都 蔡 换 为 python3。 

3. 在 终端 会 话 中 运行 Python 代码 

现在 可 以 打开 终端 窗口 并 执行 命令 python3， 再 尝试 运行 Python 代码 片段 。 请 在 终端 会 话 中 
输入 如 下 代码 行 并 按 回 车 : 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


消息 将 直接 输出 到 当前 终端 窗口 中 。 别 忘 了 ,要 关闭 Python 解释 器 ， 可 按 Ctrl+ D 或 执行 命 


令 exit()。 
4. 安装 Sublime Text 


要 安装 编辑 器 Sublime Text， 需 要 下 载 安装 程序 。 为 此 ， 可 访问 Sublime Text 网 站 主页 ， 单 
击 链 接 Download， 并 查找 macOS 安装 程序 。 下 载 安装 程序 后 运行 它 ， 再 将 Sublime Text 图 标 拖 
放 到 文件 夹 Applications 中 。 
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1.2.3 在 Linux 系统 中 搭建 Python 编程 环境 | 


Linux 系统 是 为 编程 而 设计 的 , 因此 大 多 数 Linux 计算 机 默认 安装 了 Python。 编 写 和 维护 Linux 
的 人 认为 ， 你 很 可 能 会 使 用 这 种 系统 进行 编程 ， 他 们 也 鼓励 你 这 样 做 。 因 此 ， 要 在 这 种 系统 中 编 
程 ， 你 几乎 不 用 安装 什么 软件 ， 只 需要 修改 一 些 设置 。 

1. 检查 Python 版 本 

在 你 的 系统 中 运行 应 用 程序 Terminal ( 如 果 你 使 用 的 是 Ubuntu， 可 按 Ctrl + Alt+ 工 )， 打 开 
一 个 终端 窗口 。 为 确定 安装 的 是 哪个 Python 版 本 ,请 执行 命令 python3 ( 请 注意 ， 其 中 的 p 是 小 
写 的 )。 如 果 安 装 了 Python， 这 个 命令 将 启动 Python 解释 器 。 输 出 类 似 于 下 面 这 样 ， 它 指出 了 安 
装 的 Python 版 本 ; 最 后 的 >>> 是 提示 符 ， 让 你 能 够 输入 Python 命令 。 


$ python3 

Python 3.7.2 (default, Dec 27 2018, 04:01:51) 

[GCC 7.3.0] on linux 

Type "help", "copyright", "credits" or "license" for more information. 
>>> 


上 述 输出 表明 ， 当 前 计算 机 默认 使 用 的 Python 版 本 为 Python 3.7.2。 看 到 上 述 输出 后 ， 如 果 
要 退出 Python 并 返回 到 终端 窗口 ， 可 按 Ctrl + D 或 执行 命令 exit()。 务 必 将 本 书 中 的 每 个 命令 
python 都 替换 为 python3。 

要 运行 本 书 的 代码 ， 必 须 使 用 Python 3.6 或 更 高 的 版 本 。 如 果 系 统 安装 的 是 低 于 Python 3.6 
的 版 本 ， 请 参阅 附录 A， 了 解 如 何 安装 最 新 版 。 

2. 在 终端 会 话 中 运行 Python 代码 

现在 可 打开 终端 窗口 并 执行 命令 python3 ,再 尝试 运行 Python 代码 片段 ,检查 Python 版 本 时 ， 
你 就 这 样 做 过 。 下 面 再 次 这 样 做 ， 然 后 在 终端 会 话 中 输入 如 下 代码 并 按 回 车 : 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


消息 将 直接 打印 到 当前 终端 窗口 中 。 别 忘 了 ,要 关闭 Python 解释 器 ,可 按 Ctrl+D 或 执行 命 


令 exit()。 


3. 安装 Sublime Text 


在 Linux 系统 中 ， 可 通过 Ubuntu Software Center 来 安装 Sublime Text。 为 此 ， 单 击 菜单 中 的 
Ubuntu Software 图 标 并 查找 Sublime Text， 再 通过 单 击 来 安装 它 。 
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1.3 运行 Hello World 程序 


安装 较 新 版 本 的 Python 和 Sublime Text 后 ， 就 可 以 编写 并 运行 你 的 第 一 个 Python 程序 了 。 
这 样 做 之 前 ， 需 要 设置 Sublime Text， 确 保 它 使 用 系统 中 正确 的 Python 版 本 。 然 后 ， 就 可 以 编写 
并 运行 Hello World 程序 了 。 


1.3.1 配置 Sublime Text 以 使 用 正确 的 Python 版 本 


如 果 在 你 的 系统 中 执行 命令 python 时 启动 的 是 Python 3 ， 就 无 须 做 任何 配置 ， 直 接 跳 到 下 
一 节 即 可 。 如 果 需 要 执行 命令 python3 来 启动 Python， 就 需要 配置 Sublime Text， 使 其 使 用 正确 
的 Python 版 本 来 运行 你 编写 的 程序 。 


为 此 , 单 击 Sublime Text 图 标 以 启动 它 , 也 可 在 搜索 栏 中 输入 Sublime Text 来 找到 它 再 启动 。 
选择 菜单 Tools w Build System * New Build System， 新 建 一 个 配置 文件 。 删 除 该 文件 中 的 所 有 内 
容 ， 再 输入 如 下 内 容 : 


Python3. { 
sublime-build "cmd": ["python3", "-u", "$file"], 
} 


这 上段 代码 让 Sublime Text 使 用 命令 python3 来 运行 Python 程序 。 将 这 个 文件 保存 到 Sublime 
Text 默认 打开 的 文件 夹 中 ， 并 将 其 命名 为 Python3.sublime-build。 


1.3.2 ”运行 程序 hello_world.py 


编写 第 一 个 程序 前 ， 在 系统 中 创建 一 个 名 为 python_work 的 文件 来， 用 于 存储 你 开发 的 项 目 。 

文件 名 和 文件 夹 名 称 最 好 使 用 小 写字 母 ， 并 使 用 下 划 线 代替 空格 ， 因 为 Python 采用 了 这 些 命 名 约定 。 
启动 Sublime Text， 再 选择 菜单 File w Save As 将 Sublime Text 创建 的 空 文件 存储 到 文件 夹 

python_ work 中 ,并 将 其 命名 为 hello_world.py。 文件 扩展 名 .py 告诉 Sublime Text， 文 件 中 的 代码 

是 使 用 Python 编写 的 ， 这 能 让 它 知道 如 何 运 行 这 个 程序 ， 并 以 有 帮助 的 方式 突出 其 中 的 代码 。 
保存 这 个 文件 后 ， 在 其 中 输入 如 下 代码 行 : 


hello world.py print("Hello Python world!") 


在 你 的 系统 中 ， 如 果 能 使 用 命令 python 来 启动 Python 3， 可 以 选择 菜单 Tools » Build 或 按 
Ctrl +B (在 macOSs 系统 中 为 Command + B ) 来 运行 程序 。 如 果 需 要 像 前 一 节 那 样 配置 Sublime 
Text， 请 选择 菜单 Tools w Build System * Python 3 来 运行 这 个 程序 。 从 此 以 后 ， 你 就 可 以 选择 菜 
单 Tools w Build 或 按 Ctrl +B (或 Command + B ) 来 运行 程序 了 。 


在 Sublime Text 的 底部 ， 将 出 现 一 个 终端 窗口 ， 其 中 包含 如 下 输出 : 
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Hello Python world! | 
[Finished in 0.1s] 


如 果 看 不 到 上 述 输出 ,可 能 是 因为 这 个 程序 出 了 点 问题 。 请 检查 你 输入 的 每 个 字符 。 是 否 不 
小 心 将 print 的 首 字 母 大 写 了 ? 是 否 遗 漏 了 引号 或 圆 括号 ”编程 语言 的 语法 非常 严格 ， 只 要 不 满 
足 要 求 ， 就 会 报错 。 如 果 你 无 法 运行 这 个 程序 ， 请 参阅 下 一 他 的 建议 。 


1.4 解决 安装 问题 
如 果 无 法 运行 程序 hello_ world.py， 可 尝试 如 下 几 个 解决 方法 ， 这 些 通用 方法 适用 于 所 有 编 


程 问题 。 


口 程序 存在 严重 错误 时 ，Python 将 显示 traceback， 即 错误 报告 。Python 会 仔细 研究 文件 ， 
试图 找 出 其 中 的 问题 。trackback 可 能 会 提供 线索 ， 让 你 知道 是 什么 问题 让 程序 无 法 运行 。 
口 离开 计算 机 ， 先 休息 一 会 儿 再 尝试 。 别 忘 了 ， 语 法 在 编程 中 非常 重要 ， 即 便 是 少 一 个 冒 
号 、 引 号 不 匹配 或 括号 不 匹配 ， 都 可 能 导致 程序 无 法 正确 运行 。 请 再 次 阅读 本 章 的 相关 
内 容 ， 并 重新 审视 你 编写 的 代码 ， 看 看 能 否 找 出 错误 。 
口 推倒 重 来 。 你 也 许 不 需要 伸 载 任何 软件 ， 但 删除 文件 hello_world.py 并 重新 创建 它 也 许 是 
合理 的 选择 。 
口 让 别人 在 你 的 计算 机 或 其 他 计算 机 上 按 本 章 的 步骤 重 做 一 遍 ， 并 仔细 观察 。 你 可 能 遗漏 
了 一 小 步 ， 而 别人 刚好 没有 遗漏 。 
口 请 风 Python 的 人 帮忙 。 当 你 有 这 样 的 想法 时 , 可 能 发 现在 你 认识 的 人 当中 就 有 人 使 用 Python。 
口 本 章 的 安装 说 明 在 本 书 主 页 上 : ituring.cn/book/2784。 对 你 来 说 ， 在 线 版 也 许 更 合适 ， 
为 可 以 复制 并 粘贴 其 中 的 代码 。 
口 到 网 上 寻求 帮助 。 附 录 C 提供 了 很 多 在 线 资源 ， 如 论坛 或 在 线 聊 天 网 站 ， 你 可 以 在 这 些 
地 方 请 求解 决 过 相同 问题 的 人 提供 解决 方案 。 
不 要 担心 这 会 打扰 经 验 丰 富 的 程序 员 。 每 个 程序 员 都 遇 到 过 问题 , 大 多 数 程序 员 很 乐意 帮助 
你 正确 地 设置 系统 。 只 要 能 清晰 地 说 明 你 要 做 什么 、 尝 试 了 哪些 方法 及 其 结果 ,就 很 可 能 有 人 能 
够 帮 到 你 。 正 如 前 言 中 指出 的 ，Python 社区 对 初学 者 非常 友好 。 
任何 现代 计算 机 都 能 够 运行 Python。 前 期 的 问题 可 能 令 人 诅 丧 ， 但 很 值得 你 花 时 间 去 解决 。 
能 够 运行 hello_world.py 后 , 你 就 可 以 开始 学 习 Python 了 , 而 且 编 程 工作 会 更 有 趣 , 也 更 令 人 愉快 。 


/ 


1.5 ”从 终端 运行 Python 程序 


你 编写 的 大 多 数 程序 将 直接 在 文本 编辑 器 中 运行 ,但 有 时 候 从 终端 运行 程序 很 有 用 。 例 如 ， 
你 可 能 想 直 接 运 行 赋 有 的 程序 。 
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在 任何 安装 了 Python 的 系统 上 都 可 以 这 样 做 , 前 提 是 你 知道 如 何 进 入 程序 文件 所 在 的 目录 。 
为 尝试 这 样 做 ， 请 确保 将 文件 hello world.py 存储 到 了 桌面 的 文件 夹 python work 中 。 
1.5.1 在 Windows 系统 中 从 终端 运行 Python 程序 


在 命令 窗口 中 , 可 以 使 用 终端 命令 cd ( 表示 change directory， 即 切换 目录 ) 在 文件 系统 中 导 
航 。 使 用 命令 dir (表示 directory， 即 目录 ) 可 以 显示 当前 目录 中 的 所 有 文件 。 


为 运行 程序 hello _ world.py， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命令 : 


@ C:\> cd Desktop\python_work 

@ C:\Desktop\python work> dir 
hello world.py 

四 C:\Desktop\python work> python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 夹 Desktop\python work ( 见 @ ), 接 下 来 , 使 用 命令 dir 来 
确认 这 个 文件 夹 中 包含 文件 hello_world.py( 见 @ )。 最 后 ， 使 用 命令 python hello_world.py 来 
运行 这 个 文件 ( 见 @ )。 


大 多 数 程序 可 直接 从 编辑 器 运行 , 但 待 解决 的 问题 比较 复杂 时 , 你 编写 的 程序 可 能 需要 从 终 


端 运 行 。 


1.5.2 在 Linux 和 macOsS 系统 中 从 终端 运行 Python 程序 


在 Linux 和 macOS 系统 中 ， 从 终端 运行 Python 程序 的 方式 相同 。 在 终端 会 话 中 ， 可 以 使 用 
终端 命令 cd ( 表示 change directory， 即 切换 目录 ) 在 文件 系统 中 导航 。 使 用 命令 1s〈 表示 list， 
即 列表 ) 可 以 显示 当前 目录 中 所 有 未 隐藏 的 文件 。 


为 运行 程序 hello_worldpy， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命令 : 


@ ~$ cd Desktop/python work/ 

@ ~/Desktop/python work$ 1s 
hello world.py 

@ ~/Desktop/python work$ python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 夹 Desktop/python _ work ( 见 @ )。 接 下 来 ， 使 用 命令 1s 来 
确认 这 个 文件 夹 中 包含 文件 hello_world.py( 见 @ )。 最 后 ， 使 用 命令 python hello world.py 来 
运行 这 个 文件 ( 见 @ )。 


就 这 么 简单 。 要 运行 Python 程序 ， 只 需 使 用 命令 python (或 python3 ) 即 可 。 
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动手 试 一 斌 
本 章 的 练习 都 是 探索 性 的 ， 但 从 第 2 章 开 始 将 要 求 你 用 那 一 章 学 到 的 知识 来 解决 
问题 。 
练习 1-1: python.org 浏览 Python 主页 ， 寻 找 你 感 兴趣 的 主题 。 你 对 Python 越 
熟悉 ， 这 个 网 站 对 你 来 说 就 越 有 用 。 


练习 1-2: 输入 错误 ”打开 你 刚 创 建 的 文件 hello world.py， 在 代码 中 添加 一 个 输 
入 错误 ,再 运行 这 个 程序 。 输入 错误 会 引发 错误 吗 ? 你 能 理解 显示 的 错误 消息 吗 ? 你 能 
添加 一 个 不 会 导致 错误 的 输入 错误 吗 ? 你 赁 什么 认为 它 不 会 导致 错误 ? 

练习 1-3: 无 穷 的 技艺 ”如 果 你 有 无 穷 多 种 编程 技艺 ， 你 打算 开发 什么 样 的 程序 呢 ? 
你 就 要 开始 学 习 编 程 了 。 如 果 心 中 有 目标 ， 就 能 立即 将 新 学 到 的 技能 付 诸 应 用 ， 现 在 正 
是 草拟 目标 的 大 好 时 机 。 将 想法 记录 下 来 是 个 不 错 的 习惯 ,这样 每 当 需 要 开始 新 项 目 时 ， 
都 可 参考 它们 。 现 在 请 花 点 时 间 描 绘 三 个 你 想 创建 的 程序 。 
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在 本 章 中 , 你 大 臻 了 解 了 Python, 并 在 自己 的 系统 中 安装 了 Python。 你 还 安装 了 一 个 文本 编 
辑 器 ， 以 简化 Python 代码 的 编写 工作 。 你 学 习 了 如 何在 终端 会 话 中 运行 Python 代码 片段 ， 并 运 
行 了 第 一 个 程序 一 hello world.py。 你 还 大 致 了 解 了 如 何 解决 安装 问题 。 


在 下 一 章 ， 你 将 学 习 如 何在 Python 程序 中 使 用 各 种 数据 和 变量 。 
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变量 和 简单 数据 类 型 


在 本 章 中 ， 你 将 学 习 可 在 Python 程序 中 使 用 的 各 种 数据 ， 还 将 
学 习 如 何在 程序 中 使 用 变量 来 表示 这 些 数据 。 


2.1 运行 hello_world.py 时 发 生 的 情况 


运行 hello_world.py 时 ，Python 都 做 了 些 什么 呢 ? 下 面 来 深入 研究 一 下 。 实 际 上 ， 即 便 是 运 
行 简单 的 程序 ，Python 所 做 的 工作 也 相当 多 : 


hello world.py print("Hello Python world!") 


运行 上 述 代 码 时 ， 你 将 看 到 如 下 输出 : 


Hello Python world! 


运行 文件 hello_world.py 时 ,末尾 的 .py 指出 这 是 一 个 Python 程序 ,因此 编辑 器 将 使 用 Python 
解释 器 来 运行 它 。Python 解释 器 读 取 整 个 程序 , 确定 其 中 每 个 单词 的 含义 。 例 如 ,看 到 后 面 跟着 
圆 括号 的 单词 print 时 ,解释 器 就 将 圆 括 号 中 的 内 容 打印 到 屏幕 。 
编写 程序 时 ， 编 辑 器 会 以 各 种 方式 突出 程序 的 不 同 部 分 。 例 如 ， 它 知道 print() 是 一 个 函数 
的 名 称 ， 因 此 将 其 显示 为 某 种 颜色 ; LE Python worl1dl" 不 是 Python 代码 ， 因 此 将 其 
显示 为 男 一 种 颜色 。 这 种 功能 称 为 语法 高 亮 ， 在 你 刚 开始 编写 程序 时 很 有 帮助 。 


2.2 变量 


下 面 来 尝试 在 hello_world.py 中 使 用 一 个 变量 。 在 这 个 文件 开头 添加 一 行 代码 ， 并 对 第 二 行 
代码 进行 修改 ， 如 下 所 示 ; 


hello_world.py message = "Hello Python world!" 
print(message) 


运行 这 个 程序 ， 看 看 结果 如 何 。 你 会 发 现 ， 输 出 与 以 前 相同 : 


Hello Python world! 


我 们 添加 了 一 个 名 为 message 的 变量 。 每 个 变量 都 指向 一 个 值 一 一 与 该 变量 相关 联 的 信息 。 
在 这 里 ， 指 向 的 值 为 文本 "Hello Python world!"。 

添加 变量 导致 Python 解释 器 需要 做 更 多 工作 。 处 理 第 一 行 代码 时 , 它 将 变量 message 与 文本 
"Hello Python world1" 关 联 起 来 ; 处 理 第 二 行 代码 时 ， 它 将 与 变量 message 关联 的 值 打 印 到 屏幕 。 

下 面 来 进一步 扩展 这 个 程序 : 修改 hello worldpy, 使 其 再 打印 一 条 消息 。 为 此 , 在 hello worldpy 
中 添加 一 个 空 行 ， 再 添加 下 面 两 行 代码 : 


message = "Hello Python world!" 
print(message) 


essage = "Hello Python Crash Course world!" 
print(message) 


现在 如 果 运 行 这 个 程序 ， 将 看 到 两 行 输出 : 


Hello Python world! 
Hello Python Crash Course world! 


在 程序 中 可 随时 修改 变量 的 值 ， 而 Python 将 始终 记录 变量 的 最 新 值 。 


2.2.1 变量 的 命名 和 使 用 
在 Python 中 使 用 变量 时 ， 需 要 遵守 一 些 规则 和 指南 。 违 反 这 些 规则 将 引发 错误 ， 而 指南 旨 
在 让 你 编写 的 代码 更 容易 阅读 和 理解 。 请 务必 牢记 下 述 有 关 变 量 的 规则 。 
口 变量 名 只 能 包含 字母 、 数 字 和 下 划 线 。 变 量 名 能 以 字母 或 下 划 线 打头 ， 但 不 能 以 数字 打 
头 。 例 如 ， 可 将 变量 命名 为 message 1， 但 不 能 将 其 命名 为 1 message。 
口 变量 名 不 能 包含 空格 ， 但 能 使 用 下 划 线 来 分 隔 其 中 的 单词 。 例 如 ， 变 量 名 greeting 


message 可 行 ， 但 变量 名 greeting message 会 引发 错误 。 
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口 不 要 将 Python 关键 字 和 函数 名 用 作 变 量 名 , 即 不 要 使 用 Python 保留 用 于 特殊 用 途 的 单词 ， 
如 print (请 参见 附录 A.4 )。 

口 变量 名 应 既 简短 又 具有 描述 性 。 例 如, name 比 n 好 ,， student _name 比 sn 好 , name length 
比 length of _persons_name 好 。 

口 慎 用 小 写字 母 1 和 大 写字 母 0， 因 为 它们 可 能 被 人 错 看 成 数字 1 和 0。 


要 创建 良好 的 变量 名 ， 需 要 经 过 一 定 的 实践 ,在 程序 复杂 而 有 趣 时 尤其 如 此 。 随 着 编写 的 程 
序 越 来 越 多 ， 并 开始 阅读 别人 编写 的 代码 ， 你 将 越 来 越 善于 创建 有 意义 的 变量 名 。 


注意 就 目前 而 言 , 应 使 用 小 写 的 Python 变量 名 。 虽 然 在 变量 名 中 使 用 大 写字 母 不 会 导致 错误 ， 
但 是 大 写字 母 在 变量 名 中 有 特殊 含义 ， 这 将 在 本 书后 面 讨 论 。 


2.2.2 ”使 用 变量 时 避免 命名 错误 
程序 员 都 会 犯错 , 而 且 大 多 数 程序 员 每 天 都 会 犯错 。 虽然 优秀 的 程序 员 也 会 犯错 , 但 他 们 也 
知道 如 何 高 效 地 消除 错误 。 下 面 来 看 一 种 你 可 能 犯 的 错误 ， 并 学 习 如 何 消除 它 。 


我 们 将 有 意 地 编写 一 些 引 发 错误 的 代码 。 请 输入 下 面 的 代码 , 包括 其 中 拼写 不 正确 、 以 粗 体 
显示 的 单词 mesage: 


message = "Hello Python Crash Course reader!" 
print(mesage) 


程序 存在 错误 时 ，Python 解释 器 将 竭尽 所 能 地 帮助 你 找 出 问题 所 在 。 程 序 无 法 成 功 运行 时 ， 
解释 器 将 提供 一 个 traceback。 traceback 是 一 条 记录 , 指出 了 解释 器 尝试 运行 代码 时 , 在 什么 地 方 
陷入 了 困境 。 下 面 是 你 不 小 心 错 误 地 拼写 了 变量 名 时 ，Python 解释 器 提供 的 traceback: 


Traceback (most recent call last): 
@ File "hello world.py", line 2, in <module> 
@ print(mesage) 
四 NameError: name 'mesage' is not defined 


解释 器 指出 ， 文 件 hello_world.py 的 第 二 行 存在 错误 ( 见 @ )。 它 列 出 了 这 行 代 码 ， 旨 在 帮助 
你 快速 找 出 错误 ( 见 @ )， 还 指出 了 它 发 现 的 是 什么 样 的 错误 ( 见 @ )。 在 这 里 ,解释 器 发 现 了 一 
个 名 称 错误 ， 并 报告 打印 的 变量 mesage 未 定义 : Python 无 法 识别 你 提供 的 变量 名 。 名 称 错误 通 
常 意味 着 两 种 情况 : 要 么 是 使 用 变量 前 忘记 给 它 赋 值 ， 要 么 是 输入 变量 名 时 拼写 不 正确 。 

在 这 个 示例 中 ， 第 二 行 的 变量 名 message 遗漏 了 字母 s。Python 解释 器 不 会 对 代码 做 拼写 检 
查 ， 但 要 求 变 量 名 的 拼写 一 致 。 例 如 ， 如 果 在 代码 的 另 一 个 地 方 也 将 message 错误 地 拼写 成 了 
mesage， 结 果 将 如 何 呢 ? 


mesage = "Hello Python Crash Course reader!" 
print (mesage) 


在 这 种 情况 下 ， 程 序 将 成 功 运行 ! 


Hello Python Crash Course reader! 


编程 语言 要 求 严格 , 但 并 不 关心 拼写 是 否 正 确 。 因 此 , 创建 变量 名 和 编写 代码 时 ， 无须 考 虑 
英语 中 的 拼写 和 语法 规则 。 

很 多 编程 错误 都 简单 ， 只 是 在 程序 的 某 一 行 输 错 了 一 个 字符 。 为 找 出 这 种 错误 而 花费 很 长 时 
间 的 大 有 人 在 。 很 多 程序 员 天 资 聪颖 、 经 验 丰富 ， 却 为 找 出 这 种 细微 的 错误 花费 数 小 时 。 你 可 能 
觉得 这 很 好 笑 ， 但 别 忘 了 ， 在 你 的 编程 生涯 中 ， 经 常会 有 同样 的 遭遇 。 


2.2.3 ”变量 是 标签 

变量 常 被 描述 为 可 用 于 存储 值 的 盒子 。 在 你 刚 接 触 变量 时 ,这 种 定义 可 能 很 有 帮助 , 但 它 并 
没有 准确 描述 Python 内 部 表示 变量 的 方式 。 一 种 好 得 多 的 定义 是 ， 变 量 是 可 以 赋 给 值 的 标签 ， 
也 可 以 说 变量 指向 特定 的 值 。 

刚 学 习 编程 时 ,这 种 差别 可 能 意义 不 大 , 但 越 早 知道 越 好 。 你 迟早 会 遇 到 变量 的 行为 出 乎 意 
料 的 情形 ， 此 时 如 果 对 变量 的 工作 原理 有 准确 的 认识 ， 将 有 助 于 搞 清 楚 代码 是 如 何 运 行 的 。 


注意 ”要 理解 新 的 编程 概念 ， 最 佳 的 方式 是 尝试 在 程序 中 使 用 它们 。 如 果 你 在 完成 本 书 的 练习 
时 陷入 了 困境 ,请 尝试 做 点 其 他 的 事情 。 如 果 这 样 做 后 依然 无 法 摆脱 困境 ， 请 复习 相关 
内 容 。 如 果 这 样 做 后 情况 依然 如 故 ， 请 参阅 附录 C 的 建议 。 


动手 试 一 斌 
在 完成 下 面 的 每 个 练习 时 ,都 编写 一 个 独立 的 程序 。 保存 每 个 程序 时 , 使 用 符合 标准 
Python 约定 的 文件 名 :使 用 小 写字 母 和 下 划 线 , 如 simple message.py 和 Simple messages.py。 


练习 2-1: 简单 消息 “将 一 条 消息 赋 给 变量 ， 并 将 其 打印 出 来 。 
练习 2-2: 多 条 简单 消息 ”将 一 条 消息 赋 给 变量 ， 并 将 其 打印 出 来 ; 再 将 变量 的 值 
修改 为 一 条 新 消息 ， 并 将 其 打印 出 来 。 
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2.3 字符 串 

大 多 数 程 序 定义 并 收集 某 种 数据 ， 然 后 使 用 它们 来 做 些 有 意义 的 事情 。 有 鉴于 此 ， 对 数据 进 
行 分 类 大 有 神 益 。 我 们 将 介绍 的 第 一 种 数据 类 型 是 字符 串 。 字 符 串 虽然 看 似 简 单 ， 但 能 够 以 很 多 
不 同 的 方式 使 用 。 

字符 串 就 是 一 系列 字符 。 在 Python 中 ， 用 引号 括 起 的 都 是 字符 串 ， 其 中 的 引号 可 以 是 单 引 
号 ， 也 可 以 是 双 引 号 ， 如 下 所 示 : 


"This is a string." 
‘This is also a string.’ 


这 种 灵活 性 让 你 能 够 在 字符 串 中 包含 引号 和 撤 号 : 


'I told my friend, "Python is my favorite languagel ” 
"The language 'Python' is named after Monty Python, not the snake." 
"One of Python's strengths is its diverse and supportive community." 


下 面 来 看 一 些 使 用 字符 串 的 方式 。 


2.3.1 使 用 方法 修改 字符 串 的 大 小 写 


对 于 字符 串 ， 可 执行 的 最 简单 的 操作 之 一 是 修改 其 中 单词 的 大 小 写 。 请 看 下 面 的 代码 ,并 学 
试 判断 其 作用 : 


name.py name = "ada lovelace" 
print(name.title()) 


将 这 个 文件 保存 为 name.py， 表 运行 它 。 你 将 看 到 如 下 输出 : 


Ada Lovelace 


在 这 个 示例 中 ， 变 量 name 指向 小 写 的 字符 串 "ada lovelace"。 在 函数 调用 print() 中 ， 方 法 
title() 出 现在 这 个 变量 的 后 面 。 方 法 是 Python 可 对 数据 执行 的 操作 。 在 name.title() 中 ，name 
后 面 的 句点 〈. ) 让 Python 对 变量 name 执行 方法 title() 指 定 的 操作 。 每 个 方法 后 面 都 跟着 一 对 
圆 括号 ， 这 是 因为 方法 通常 需要 额外 的 信息 来 完成 其 工作 。 这 种 信息 是 在 圆 括号 内 提供 的 。 函 数 
title() 不 需要 额外 的 信息 ， 因 此 它 后 面 的 圆 括 号 是 空 的 。 

方法 title() 以 首 字母 大 写 的 方式 显示 每 个 单词 ， 即 将 每 个 单词 的 首 字母 都 改 为 大 写 。 这 很 
有 用 ， 因 为 你 经 常 需要 将 名 字 视 为 信息 。 例 如 ， 你 可 能 希望 程序 将 值 Ada、ADA 和 ada 视 为 同一 
个 名 字 ， 并 将 它们 都 显示 为 Ada。 


还 有 其 他 几 个 很 有 用 的 大 小 写 处 理 方法 。 例 如 , 要 将 字符 串 改 为 全 部 大 写 或 全 部 小 写 ,可 以 
像 下 面 这 样 做 : 


name = "Ada Lovelace" 2 


print(name.upper()) 
print(name.lower()) 


这 些 代 码 的 输出 如 下 : 


ADA LOVELACE 
ada lovelace 


存储 数据 时 ， 方 法 lower() 很 有 用 。 很 多 时 候 ， 你 无 法 依靠 用 户 来 提供 正确 的 大 小 写 ， 因 此 
需要 将 字符 串 先 转换 为 小 写 , 再 存储 它们 。 以 后 需要 显示 这 些 信息 时 , 再 将 其 转换 为 最 合适 的 大 
小 写 方式 。 


2.3.2 ”在 字符 串 中 使 用 变量 


在 有 些 情 况 下 , 你 可 能 想 在 字符 串 中 使 用 变量 的 值 。 例如 ,你 可 能 想 使 用 两 个 变量 分 别 表示 
名 和 姓 ， 然 后 合并 这 两 个 值 以 显示 姓名 : 


full name.py first name = "ada" 
last name = "lovelace" 
@ full name = f"{first name} {last name}" 
print(full name) 


要 在 字符 串 中 插入 变量 的 值 ,可 在 前 引号 前 加 上 字母 f( 见 @ ), 再 将 要 搬入 的 变量 放 在 花 括 
号 内 。 这 样 ， 当 Python 显示 字符 串 时 ， 将 把 每 个 变量 都 替换 为 其 值 。 

这 种 字符 串 名 为 f 字 符 串 。f 是 format (设置 格式 ) 的 简写 ， 因 为 Python 通过 把 花 括 号 内 的 
变量 奉 换 为 其 值 来 设置 字符 串 的 格式 。 上 述 代 码 的 输出 如 下 : 


ada lovelace 


使 用 f 字 符 串 可 完成 很 多 任务 ， 如 利用 与 变量 关联 的 信息 来 创建 完整 的 消息 ， 如 下 所 示 : 


first name = "ada" 

last name = "lovelace" 

full name = f"{first name} {last name}" 
@ print(f"Hello, {full name.title()}!") 


在 这 里 , 一 个 问候 用 户 的 句子 中 使 用 了 完整 的 姓名 ( 见 @ ), 并 使 用 方法 title() 来 将 姓名 设 
置 为 合适 的 格式 。 这 些 代码 显示 一 条 格式 良好 的 简单 问候 语 : 
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Hello, Ada Lovelacel 


还 可 以 使 用 f 字 符 串 来 创建 消息 ， 再 把 整 条 消息 赋 给 变量 : 


first name = "ada" 
last name = "lovelace" 
full name = f"{first name} {last name}" 
@ message = f"Hello, {full name.title()}!" 
@ print(message 


上 述 代 码 也 显示 消息 Hello, Ada Lovelace! ,但 将 这 条 消息 赋 给 了 一 个 变量 ( 见 @ )， 这 让 最 
后 的 函数 调用 print() 变 得 简单 得 多 ( 见 @ )。 


注意 f 字 符 串 是 Python 3.6 引入 的 。 如果 你 使 用 的 是 Python 3.5 或 更 早 的 版 本 ,需要 使 用 format() 
方法 ， 而 非 这 种 语法。 要 使 用 方法 format()， 可 在 圆 括号 内 列 出 要 在 字符 串 中 使 用 的 
变量 。 对 于 每 个 变量 ， 都 通过 一 对 花 括 号 来 引用 。 这 样 将 按 顺 序 将 这 些 花 括号 替换 为 贺 
括号 内 列 出 的 变量 的 值 ， 如 下 所 示 : 


full name = "{} {}".format(first name, last name) 


2.3.3 ”使 用 制 表 符 或 换行 符 来 添加 空白 


在 编程 中 , 空白 泛 指 任何 非 打 印字 符 ， 如 空格 、 制 表 符 和 换行 符 。 你 可 以 使 用 空白 来 组 织 输 
出 ， 让 用 户 阅读 起 来 更 容易 。 
要 在 字符 串 中 添加 制 表 符 ， 可 使 用 字符 组 合 \t， 如 下 述 代 码 的 @ 处 所 示 : 


>>> print("Python") 
Python 
@ >>> print("\tPython") 
Python 


要 在 字符 串 中 添加 换行 符 ， 可 使 用 字符 组 合 \n: 


>>> print("Languages:\npython\nC\nJavaScript") 
Languages: 

Python 

a 

JavaScript 


还 可 在 同一 个 字符 串 中 同时 包含 制 表 符 和 换行 符 。 字符 串 "\n\t" 计 Python 换 到 下 一 行 , 并 在 
下 一 行 开头 添加 一 个 制 表 符 。 下 面 的 示例 演示 了 如 何 使 用 一 个 单行 字符 串 来 生成 四 行 输出 : 


>>> print("Languages:\n\tPython\n\tC\n\tJavaScript") 
Languages: 

Python 

C 

JavaScript 


在 接 下 来 的 两 章 中 , 你 将 使 用 为 数 不 多 的 几 行 代码 来 生成 很 多 行 输出 ,届时 制 表 符 和 换行 符 
将 提供 极 大 的 帮助 。 


2.3.4 删除 空 

在 程序 中 ,额外 的 空白 可 能 令 人 迷惑 。 对 程序 员 来 说 ，'python' 和 'python ' 看 起 来 几乎 没 什 
么 两 样 ， 但 对 程序 来 说 ， 它 们 却 是 两 个 不 同 的 字符 串 。Python 能 够 发 现 'python' 中 额外 的 空白 ， 
并 认为 它 意义 重大 一 一 除非 你 告诉 它 不 是 这 样 的 。 

空白 很 重要 ， 因 为 你 经 常 需要 比较 两 个 字符 串 是 否 相 同 。 一 个 重要 的 示例 是 ,在 用 户 登 录 网 
站 时 检查 其 用 户 名 。 不 过 在 非常 简单 的 情形 下 ， 额 外 的 空格 也 可 能 令 人 迷惑 。 所 幸 ， 在 Python 
中 删除 用 户 输入 数据 中 的 多 余 空白 易如反掌 。 

Python 能 够 找 出 字符 串 开头 和 末尾 多 余 的 空白 。 要 确保 字符 串 末 尾 没有 空白 ， 可 使 用 方法 
rstrip()。 


@ >>> favorite language = 'python ' 
@ >>> favorite language 
"python ” 
@ >>> favorite language.rstrip() 
‘python’ 
@ >>> favorite language 
"python ” 


与 变量 favorite_language 相关 联 的 字符 串 末 尾 有 多 余 的 空白 ( 见 @ )。 你 在 终端 会 话 中 癌 
Python 询问 这 个 变量 的 值 时 ， 可 看 到 末尾 的 空格 ( 见 @ )。 对 变量 favorite_language 调用 方法 
rstrip() 后 ( 见 @ )， 这 个 多 余 的 空格 被 删除 了 。 然 而 ， 这 种 删除 只 是 暂时 的 ， 接 下 来 再 次 询问 
favorite_language 的 值 时 ， 你 会 发 现 这 个 字符 串 与 输入 时 一 样 ， 依 然 包含 多 余 的 空白 ( 见 @ )。 


要 永久 删除 这 个 字符 串 中 的 空白 ， 必 须 将 删除 操作 的 结果 关联 到 变量 : 


>>> favorite language = "python ' 

@ >>> favorite language = favorite language.rstrip() 
>>> favorite language 
'python’ 


为 删除 这 个 字符 串 中 的 空白 ， 要 将 其 末尾 的 空白 剔除 ， 再 将 结果 关联 到 原来 的 变量 ( 见 @ )。 
在 编程 中 ,经常 需要 修改 变量 的 值 ， 再 将 新 值 关 联 到 原来 的 变量 。 这 就 是 变量 的 值 可 能 随 程序 的 
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运行 或 用 户 输入 数据 而 发 生变 化 的 原因 所 在 。 


你 还 可 以 剔除 字符 串 开 头 的 空白 ,或 者 同时 剔除 字符 串 两 边 的 空白 。 为 此 ， 可 分 别 使 用 方法 
lstrip() 和 strip(): 


@ >>> favorite language = ”python 

@ >>> favorite language.rstrip() 
”python” 

@ >>> favorite language.1lstrip() 
"python 

@ >>> favorite language.strip() 
"python 


在 这 个 示例 中 ， 我 们 首先 创建 了 一 个 开头 和 末尾 都 有 空白 的 字符 串 〈 见 @ )。 接 下 来 ， 分 别 
删除 末尾 〈 见 @@ )、 开 头 ( 见 @ ) 和 两 边 ( 见 @ ) 的 空白 。 尝 试 使 用 这 些 剥 除 函数 有 助 于 你 熟悉 
字符 串 操作 。 在 实际 程序 中 ， 这 些 剥 除 函 数 最 常用 于 在 存储 用 户 输入 前 对 其 进行 清理 。 


2.3.5 ”使 用 字符 串 时 避免 语法 错误 

语法 错误 是 一 种 你 时 不 时 会 遇 到 的 错误 。 程 序 中 包含 非法 的 Python 代码 时 ， 就 会 导致 语法 
错误 。 例 如 ， 在 用 单 引 号 括 起 的 字符 串 中 ， 如 果 包 含 撤 号 ， 就 将 导致 错误 。 这 是 因为 这 会 导致 
Python 将 第 一 个 单 引号 和 撤 号 之 间 的 内 容 视 为 一 个 字符 串 ， 进而 将 余下 的 文本 视 为 Python 代码 ， 
从 而 引发 错误 。 

下 面 演示 了 如 何 正确 地 使 用 单 引号 和 双 引 号 。 请 将 该 程序 保存 为 apostrophe.py， 再 运行 它 : 


aposirophe.py ”message = "One of Python's strengths is its diverse community." 
print(message) 


撤 号 位 于 两 个 双 引 号 之 间 ， 因 此 Python 解释 器 能 够 正确 地 理解 这 个 字符 串 : 


One of Python's strengths is its diverse community. 


然而 ， 如 果 使 用 单 引号 ，Python 将 无 法 正确 地 确定 字符 串 的 结束 位 置 : 


message = 'One of Python's strengths is its diverse Communjity . 
print(message) 


你 将 看 到 如 下 输出 : 


File "apostrophe.py", line 1 
message = 'One of Python's strengths is its diverse Community . 
人 
© 
SyntaxError: invalid syntax 


2.4 数 21 


从 上 述 输出 可 知 ， 错 误 发 生 在 第 二 个 单 引号 后 面 ( 见 @ )。 这 种 语法 错误 表明 ， 在 解释 顺 看 
来 ， 其 中 的 有 些 内 容 不 是 有 效 的 Python 代码 。 错 误 的 原因 各 种 各 样 ， 我 将 指出 一 些 常 见 的 原因 。 
学 习 编 写 Python 代码 时 ， 你 可 能 会 经 常 遇 到 语法 错误 。 语 法 错误 也 是 最 不 具体 的 错误 类 型 ， 
此 可 能 难以 找 出 并 修复 。 受 困 于 非常 棘手 的 错误 时 ， 请 参阅 附录 C 提供 的 建议 。 


注意 “编写 程序 时 ， 编 辑 器 的 语法 高 亮 功能 可 帮助 你 快速 找 出 某 些 语法 错误 。 看 到 Python 代码 
以 普通 句子 的 颜色 显示 ， 或 者 普通 句子 以 Python 代码 的 颜色 显示 时 ， 就 可 能 意味 着 文件 
中 存在 引号 不 匹配 的 情况 。 


动手 试 一 斌 

完成 下 面 的 每 个 练习 时 ,都 编写 一 个 独立 的 程序 , 并 将 其 保存 为 名 称 类似 于 name 
cases.py 的 文件 。 如 果 遇 到 了 困难 ， 请 休息 一 会 儿 或 参阅 附录 C 提供 的 建议 。 

练习 2-3: 个 性 化 消息 “用 变量 表示 一 个 人 的 名 字 ， 并 向 其 显示 一 条 消息 。 显 示 的 
消息 应 非常 简单 ， 下 面 是 一 个 例子 。 

Hello Eric, would you like to learn some Python today? 

练习 2-4: 调整 名 字 的 大 小 写 ”用 变量 表示 一 个 人 的 名 字 ， 再 以 小 写 、 大 写 和 首 字 
母 大 写 的 方式 显示 这 个 人 名 。 

练习 2-5: 名 言 找 一 句 你 钦佩 的 名 人 说 的 名 言 ， 将 其 姓名 和 名 言 打 印 出 来 。 输 出 
应 类 似 于 下 面 这 样 ( 包括 引号 )。 


Albert Einstein once said, “A person who never made a mistake never tried anything new.” 


练习 2-6: 名 言 2 重复 练习 2-$， 但 用 变量 famous person 表示 名 人 的 姓名 ， 再 创 
建 要 显示 的 消息 并 将 其 赋 给 变量 message， 然 后 打印 这 条 消息 。 

练习 2-7: 别 除 人 名 中 的 空白 用 变量 表示 一 个 人 的 名 字 ， 并 在 其 开头 和 末尾 都 包 
含 一 些 空白 字符 。 务 必 至 少 使 用 字符 组 合 "\t" 和 "\n" 各 一 次 。 


打印 这 个 人 名 ， 显 示 其 开头 和 末尾 的 空白。 然后 ， 分 别 使 用 别 除 函数 lstrip()、 
rstrip() 和 strip() 对 人 名 进行 处 理 ， 并 将 结果 打印 出 来 。 


2.4 数 


在 编程 中 ， 经 常 使 用 数 来 记录 得 分 、 表 示 可 视 化 数据 、 存 储 Web 应 用 信息 ， 等 等 。Python 
能 根据 数 的 用 法 以 不 同 的 方式 处 理 它们 。 鉴 于 整数 使 用 起 来 最 简单 ， 下 面 就 先 来 看 看 Python 是 
如 何 管理 它们 的 。 
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2.4.1 整数 
在 Python 中 ， 可 对 整数 执行 加 (+ ) 减 (-) 乘 (*) 除 


(/ ) 运算 。 


>>> 2 +3 
5 

>>>3 - 2 
1 
>>>2*3 
6 

>>> 3 / 2 
1.5 


在 终端 会 话 中 ，Python 直接 返回 运算 结果 。Python 使 用 两 个 乘 号 表示 乘 方 运算 : 


>>> 3 ** 2 


>>> 10 ** 6 
1000000 


Python 还 支持 运算 次 序 , 因此 可 在 同一 个 表达 式 中 使 用 多 种 运算 。 还 可 以 使 用 圆 括号 来 修改 


运算 次 序 ， 让 Python 按 你 指定 的 次 序 执行 运算 ， 如 下 所 示 


>>> 2 + 3*4 

14 

>>> (2 + 3)*4 
20 


在 这 些 示例 中 ， 空 格 不 影响 Python 计算 表达 式 的 方式 。 它 们 的 存在 则 在 让 你 在 阅读 代码 时 


能 迅速 确定 先 执行 哪些 运算 。 


2.4.2” 浮 点 数 
Python 将 所 有 带 小 数 点 的 数 称 为 浮 点 数 。 大 多 数 编程 语 


确保 不 管 小 数 点 出 现在 什么 位 置 ， 数 的 行为 都 是 正常 的 。 


言 使 用 了 这 个 术语 ， 


它 指出 了 这 样 一 


个 事实 : 小 数 点 可 出 现在 数 的 任何 位 置 。 每 种 编程 语言 都 必须 细心 设计 ， 以 妥善 地 处 理 浮 点 数 ， 


从 很 大 程度 上 说 ,使 用 浮 点 数 时 无 须 考虑 其 行为 。 你 只 需 输 入 要 使 用 的 数 ， Python 通常 会 按 


你 期 望 的 方式 处 理 它们 : 


>>> 0.1 + 0.1 
0.2 
>>> 0.2 + 0.2 
0.4 
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>>> 2 0.1 


但 需要 注意 的 是 ， 结 果 包 含 的 小 数位 数 可 能 是 不 确定 的 : 


>>> 0.2 + 0.1 
0.30000000000000004 
>>> 3 * 0.1 
0.30000000000000004 


所 有 语言 都 存在 这 种 问题 ,没有 什么 可 担心 的 。 Python 会 尽力 找到 一 种 精确 表示 结果 的 方法 ， 
但 鉴于 计算 机 内 部 表示 数 的 方式 , 这 在 有 些 情况 下 很 难 。 就 现在 而 言 ， 暂 时 忽略 多 余 的 小 数位 数 
即 可 。 在 第 二 部 分 的 项 目 中 ， 你 将 在 需要 时 学 习 处 理 多 余 小 数位 的 方式 。 


2.4.3 ”整数 和 浮 点 数 
将 任意 两 个 数 相 除 时 ,结果 总 是 浮 点 数 ， 即 便 这 两 个 数 都 是 整数 且 能 整除 : 


>>> 4/2 
2:0 


在 其 他 任何 运算 中 ， 如 果 一 个 操作 数 是 整数 ， 另 一 个 操作 数 是 浮 点 数 ， 结 果 也 总 是 浮 点 数 : 


>>> 1 + 2.0 


>>> 3.0 ** 2 
9.0 


无 论 是 哪 种 运算 ,只 要 有 操作 数 是 浮 点 数 ，Python 默认 得 到 的 总 是 浮 点 数 ， 即 便 结果 原本 为 
整数 也 是 如 此 。 


2.4.4 数 中 的 下 划 线 
书写 很 大 的 数 时 ， 可 使 用 下 划 线 将 其 中 的 数字 分 组 ， 使 其 更 清晰 易 读 : 


>>> universe age = 14_000 000 000 


当 你 打印 这 种 使 用 下 划 线 定义 的 数 时 ，Python 不 会 打印 其 中 的 下 划 线 : 


>>> print(universe age) 
14000000000 
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这 是 因为 存储 这 种 数 时 ，Python 会 忽略 其 中 的 下 划 线 。 将 数字 分 组 时 ， 即 便 不 是 将 每 三 位 分 
成 一 组 ， 也 不 会 影响 最 终 的 值 。 在 Python 看 来 ，1000 与 1_000 没什么 不 同 ，1_000 与 10_00 也 没 
什么 不 同 。 这 种 表示 法 适用 于 整数 和 浮 点 数 ， 但 只 有 Python 3.6 和 更 高 的 版 本 支持 。 

2.4.5 同时 给 多 个 变量 赋值 

可 在 一 行 代码 中 给 多 个 变量 赋值 , 这 有 助 于 缩短 程序 并 提高 其 可 读 性 。 这 种 做 法 最 常用 于 ; 
一 系列 数 赋 给 一 组 变量 。 

例如 ， 下 面 演 示 了 如 何 将 变量 x、y 和 z 都 初始 化 为 零 : 


关 


>>> x, y, z = 0, 0, 0 


这 样 做 时 , 需要 用 逗号 将 变量 名 分 开 ; 对 于 要 赋 给 变量 的 值 ， 也 需 同样 处 理 。Python 将 按 顺 
序 将 每 个 值 赋 给 对 应 的 变量 。 只 要 变量 和 值 的 个 数 相同 ，Python 就 能 正确 地 将 它们 关联 起 来 。 


2.4.6 ”常量 
常量 类 似 于 变量 ,但 其 值 在 程序 的 整个 生命 周期 内 保持 不 变 。Python 没有 内 置 的 常量 类 型 ， 
但 Python 程序 员 会 使 用 全 大 写 来 指出 应 将 某 个 变量 视 为 常量 ， 其 值 应 始终 不 变 : 


MAX_CONNECTION9S = 5000 


在 代码 中 ， 要 指出 应 将 特定 的 变量 视 为 常量 ， 可 将 其 字母 全 部 大 写 。 


动手 试 一 斌 
练习 2-8: 数字 8 编写 四 个 表达 式 ， 分 别 使 用 加 法 、 减 法 、 乘 法 和 除法 运算 ， 但 
结果 都 是 数字 8。 为 使 用 函数 调用 print() 来 显示 结果 ， 务 必 将 这 些 表达 式 用 圆 括号 括 
起 来 。 也 就 是 说 ， 你 应 该 编写 四 行 类 似 于 下 面 的 代码 : 


print(5+3) 


输出 应 为 四 行 ， 其 中 每 行 都 只 包含 数字 8。 
练习 2-9: 最 喜欢 的 数 ” 用 一 个 变量 来 表示 你 最 喜欢 的 数 ， 再 使 用 这 个 变量 创建 一 
条 消息 ， 指 出 你 最 喜欢 的 数 是 什么 ， 然 后 将 这 条 消息 打印 出 来 。 
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2.5 注释 


在 大 多 数 编程 语言 中 ， 注 释 是 一 项 很 有 用 的 功能 。 本 书 前 面 编写 的 程序 中 都 只 包含 Python 
代码 , 但 随 着 程序 越 来 越 大 、 越 来 越 复杂 ， 就 应 在 其 中 添加 说 明 ， 对 你 解决 问题 的 方法 进行 大 至 
的 阐述 。 注 释 让 你 能 够 使 用 自然 语言 在 程序 中 添加 说 明 。 


2.5.1 如 何 编写 注释 
在 Python 中 , 注释 用 井 号 


一 、 


) 标识 。 井 号 后 面 的 内 容 都 会 被 Python 解释 器 忽略 , 如 下 所 示 : 


comment.py ## 向 大 家 问好 。 
print("Hello Python people!") 


Python 解释 器 将 忽略 第 一 行 ， 只 执行 第 二 行 。 


Hello Python people! 


2.5.2 ”该 编写 什么 样 的 注释 


编写 注释 的 主要 目的 是 阐述 代码 要 做 什么 ， 以 及 是 如 何 做 的 。 在 开发 项 目 期 间 ， 你 对 各 个 部 
分 如 何 协同 工作 了 如 指 掌 ， 但 过 段 时 间 后 ， 有 些 细节 你 可 能 不 记得 了 。 当 然 ， 你 总 是 可 以 通过 研 
究 代码 来 确定 各 个 部 分 的 工作 原理 , 但 通过 编写 注释 以 清晰 的 自然 语言 对 解决 方案 进行 概述 ,可 
节省 很 多 时 间 。 

要 成 为 专业 程序 员 或 与 其 他 程序 员 合作 ， 就 必须 编写 有 意义 的 注释 。 当 前 ,大 多 数 软件 是 合 
作 编 写 的 ， 编 写 者 可 能 是 同一 家 公司 的 多 名 员工 ， 也 可 能 是 众多 致力 于 同一 个 开源 项 目的 人 员 。 
训练 有 素 的 程序 员 都 希望 代码 中 包含 注释 ， 因 此 你 最 好 从 现在 开始 就 在 程序 中 添加 描述 性 注释 。 
作为 新 手 ， 最 值得 养 成 的 习惯 之 一 就 是 在 代码 中 编写 清晰 、 简 洁 的 注释 。 

如 果 不 确定 是 否 要 编写 注释 ,就 问 问 自己 : 在 找到 合理 的 解决 方案 之 前 ,考虑 了 多 个 解决 方 
案 吗 ?如 果 管 案 是 肯定 的 ， 就 编写 注释 对 你 的 解决 方案 进行 说 明 吧 。 相 比 回 过 头 去 再 添加 注释 ， 
删除 多 余 的 注释 要 容易 得 多 。 从 现在 开始 ， 本 书 的 示例 都 将 使 用 注释 来 阐述 代码 的 工作 原理 。 
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练习 2-10: 添加 注释 ”选择 你 编写 的 两 个 程序 ， 在 每 个 程序 中 至 少 添加 一 条 注释 。 


如 果 程 序 太 简 单 ， 实 在 没有 什么 需要 说 明 的 ,就 在 程序 文件 开头 加 上 你 的 姓名 和 当前 日 
期 再 用 一 句 话 阐述 程序 的 功能 。 
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2.6 ”Python 之 禅 


经 验 丰富 的 程序 员 倡 导 尽 可 能 避 繁 就 简 。Python 社区 的 理念 都 包含 在 Tim Peters 撰写 的 
“Python 之 禅 ”中 。 要 获悉 这 些 有 关 编 写 优 秀 Python 代码 的 指导 原则 ， 只 需 在 解释 器 中 执行 命令 
import this。 这 里 不 打算 歼 述 整个 “Python 之 禅 ” ， 而 只 与 大 家 分 享 其 中 的 几 条 原则 ， 让 你 明白 
为 何 它们 对 Python 新 手 来 说 至 关 重 要 。 


>>> import this 
The Zen of Python，by Tim Peters 
Beautiful is better than ugly. 


Python 程序 员 笃 信 代 码 可 以 编写 得 漂亮 而 优雅 。 编 程 是 要 解决 问题 的 , 设计 良好 、 高 效 而 漂 
亮 的 解决 方案 都 会 让 程序 员 心 生 敬 意 。 随 着 你 对 Python 的 认识 越 来 越 深 入 ， 并 使 用 它 来 编写 越 
来 越 多 的 代码 ， 有 一 天 也 许 会 有 人 站 在 你 后 面 惊 呼 :“ 哇 ,代码 编写 得 真是 漂亮 1” 


Simple is better than complex. 


如 果 有 两 个 解决 方案 ,一 个 简单 、 一 个 复杂 ,但 都 行 之 有 效 ， 就 选择 简单 的 解决 方案 吧 。 这 
样 ， 你 编写 的 代码 将 更 容易 维护 ， 你 或 他 人 以 后 改进 这 些 代码 时 也 会 更 容易 。 


Complex is better than complicated. 


现实 是 复杂 的 ， 有 时 候 可 能 没有 简单 的 解决 方案 。 在 这 种 情况 下， 就 选择 最 简单 可 行 的 解决 


Readability counts. 


即便 是 复杂 的 代码 ,也 要 让 它 易于 理解 。 开 发 的 项 目 涉及 复杂 代码 时 ， 一 定 要 为 这 些 代码 纺 
写 有 益 的 注释 。 


There should be one-- and preferably only one --obvious way to do it. 


如 果 让 两 名 Python 程序 员 去 解决 同一 个 问题 ， 他 们 提供 的 解决 方案 应 大 致 相同 。 这 并 不 是 
说 编程 没有 创意 空间 ， 而 是 恰恰 相反 ! 然而 , 大 部 分 编程 工作 是 使 用 常见 解决 方案 来 解决 简单 的 
小 问题 , 但 这 些小 问题 都 包含 在 更 庞大 、 更 有 创意 空间 的 项 目 中 。 在 你 的 程序 中 ,各 种 具体 细节 
对 其 他 Python 程序 员 来 说 都 应 易于 理解 。 


Now is better than never. 


你 可 以 用 余生 来 学 习 Python 和 编程 的 纷繁 难 懂 之 处 ,但 这 样 你 什么 项 目 都 完 不 成 。 不 要 企 
图 编写 完美 无 缺 的 代码 ,而 是 要 先 编写 行 之 有 效 的 代码 , 再 决定 是 对 其 做 进一步 改进 ,还 是 转 而 


2.7 小结 27 


去 编写 新 代码 。 
等 你 进入 下 一 章 ， 开 始 研究 更 复杂 的 主题 时 ,务必 牢记 这 种 简约 而 清晰 的 理念 。 如 此 ， 经 
验 丰富 的 程序 员 定 将 对 你 编写 的 代码 心 生 敬意 ， 进 而 乐意 向 你 提供 反馈 ， 并 与 你 合作 开发 有 趣 


的 项 目 。 
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练习 2-11: Python 之 禅 ”在 Python 终端 会 话 中 执行 命令 import this， 并 粗略 地 
浏览 一 下 其 他 的 指导 原则 。 


2.7 小 结 


在 本 章 中 , 你 学 习 了 : 如 何 使 用 变量 ; 如 何 创建 描述 性 变量 名 以 及 如 何 消 除名 称 错误 和 语法 
错误 ; 字符 串 是 什么 ,以 及 如 何 使 用 小 写 、 大 写 和 首 字 母 大 写 方式 显示 字符 串 ; 使 用 空白 来 显示 
整洁 的 输出 ， 以 及 如 何 剔除 字符 串 中 多 余 的 空白 ; 如 何 使 用 整数 和 浮 点 数 ; 一 些 使 用 数值 数据 的 
方式 。 你 还 学 习 了 如 何 编写 说 明 性 注释 ， 让 代码 对 你 和 其 他 人 来 说 更 容易 理解 。 最 后 ， 你 了 解 了 
让 代码 尽 可 能 简单 的 理念 。 


在 第 3 章 , 你 将 学 习 如 何在 被 称 为 列表 的 变量 中 存储 一 系列 信息 ,以 及 如 何 通过 遍历 列表 来 
操作 其 中 的 信息 。 


第 3 章 
列表 简介 


在 本 章 和 下 一 章 中 ， 你 将 学 习 列 表 是 什么 以 及 如 何 使 用 列表 元 
素 。 列表 让 你 能 够 在 一 个 地 方 存储 成 组 的 信息 , 其 中 可 以 只 包含 几 个 
元 素 , 也 可 以 包含 数 百 万 个 元 素 。 列表 是 新 手 可 直接 使 用 的 最 强大 的 
Python 功能 之 一 ， 它 融合 了 众多 重要 的 编程 概念 。 


[eit 
视频 讲解 


3.1 列表 是 什么 


列表 由 一 系列 按 特定 顺序 排列 的 元 素 组 成 。 你 可 以 创建 包含 字母 表 中 所 有 字母 、 数 字 0 ~9 
或 所 有 家 庭 成 员 姓名 的 列表 ; 也 可 以 将 任何 东西 加 入 列表 中 , 其 中 的 元 素 之 间 可 以 没有 任何 关系 。 
列表 通常 包含 多 个 元 素 ， 因 此 给 列表 指定 一 个 表示 复数 的 名 称 (如 letters、digits 或 names ) 
是 个 不 错 的 主意 。 


在 Python 中 ， 用 方 括号 ([] ) 表示 列表 ， 并 用 逗号 分 隔 其 中 的 元 素 。 下 面 是 一 个 简单 的 列 
表示 例 ， 其 中 包含 几 种 自行 车 : 


bicycles.py bicycles = ['trek', 'cannondale', 'redline', 'specialized'] 
print(bicycles) 


如 果 让 Python 将 列表 打印 出 来 ，Python 将 打印 列表 的 内 部 表示 ， 包 括 方 插 号 : 


['trek', 'cannondale', 'redline', 'specialized'| 


鉴于 这 不 是 你 要 让 用 户 看 到 的 输出 ， 下 面 来 学 习 如 何 访 问 列表 元 素 。 
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3.1.1 访问 列表 元 素 


列表 是 有 序 集合 ， 因 此 要 访问 列表 的 任意 元 素 ， 只 需 将 该 元 素 的 位 置 ( 索引 ) 告诉 Python 
即 可 。 要 访问 列表 元 素 ， 可 指出 列表 的 名 称 ， 再 指出 元 素 的 索引 ， 并 将 后 者 放 在 方 括号 内 。 


例如 ， 下 面 的 代码 从 列表 bicycles 中 提取 第 一 款 自行 车 : 


bicycles = ['trek', 'cannondale', 'redline', "specialized ] 
@ print(bicycles[0]) 


@ 人 处 演示 了 访问 列表 元 素 的 语法 。 当 你 请 求 获取 列表 元 素 时 ，Python 只 返回 该 元 素 ， 而 不 包 
括 方 括号 : 


trek 


这 正 是 你 要 让 用 户 看 到 的 结果 一 一 整洁 、 干 净 的 输出 。 


你 还 可 以 对 任意 列表 元 素 调用 第 2 章 介 绍 的 字符 串 方 法 。 例 如 ， 可 使 用 方法 title() 让 元 素 
'trek' 的 格式 更 整洁 : 


bicycles = ['trek', 'cannondale', 'redline', 'specialized'|] 
print(bicycles[0].title()) 


这 个 示例 的 输出 与 前 一 个 示例 相同 ， 只 是 首 字 母 T 是 大 写 的 。 


3.1.2 索引 从 0 而 不 是 1 开始 
在 Python 中 ,第 一 个 列表 元 素 的 索引 为 0， 而 不 是 1。 大 多 数 编程 语言 是 如 此 规定 的 ， 这 与 
列表 操作 的 底层 实现 相关 。 如 果 结 果 出 乎 意料 ， 请 看 看 你 是 否 犯 了 简单 的 差 一 错误 。 


第 二 个 列表 元 素 的 索引 为 1。 根 据 这 种 简单 的 计数 方式 ， 要 访问 列表 的 任何 元 素 ， 都 可 将 其 
位 置 减 1， 并 将 结果 作为 索引 。 例 如 ， 要 访问 第 四 个 列表 元 素 ， 可 使 用 索引 3。 


下 面 的 代码 访问 索引 1 和 索引 3 处 的 自行 车 : 


bicycles = ['trek', 'cannondale', 'redline', "specialized |] 
print(bicycles[1]) 
print(bicycles[3]) 


这 些 代码 返回 列表 中 的 第 二 个 和 第 四 个 元 素 : 


cannondale 
specialized 


Python 为 访问 最 后 一 个 列表 元 素 提供 了 一 种 特殊 语法 。 通 过 将 索引 指定 为 -1， 可 让 Python 
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返回 最 后 一 个 列表 元 素 : 


bicycles = ['trek', 'cannondale', 'redline', 'specialized'] 
print(bicycles[-1]) 


这 段 代码 返回 ' specialized' 。 这 种 语法 很 有 用 ， 因 为 你 经 常 需要 在 不 知道 列表 长 度 的 情况 
下 访问 最 后 的 元 素 。 这 种 约定 也 适用 于 其 他 负数 索引 。 例 如 ， 索 引 -2 返回 倒数 第 二 个 列表 元 素 ， 
索引 -3 返回 倒数 第 三 个 列表 元 素 ， 依 此 类 推 。 


3.1.3 ”使 用 列表 中 的 各 个 值 


你 可 以 像 使 用 其 他 变量 一 样 使 用 列表 中 的 各 个 值 。 例 如 ， 可 以 使 用 f 字 符 串 根 据 列表 中 的 值 
来 创建 消息 。 


下 面 尝试 从 列表 中 提取 第 一 款 自行 车 ， 并 使 用 这 个 值 创建 一 条 消息 : 


bicycles ['trek', 'cannondale', 'redline', "specialized ] 
@ message = f"My first bicycle was a {bicycles[0].title()}." 


print(message) 


我 们 使 用 bicycles[0] 的 值 生成 了 一 个 句子 ， 并 将 其 赋 给 变量 message ( 见 @ )。 输出 是 一 个 
简单 的 句子 ， 其 中 包含 列表 中 的 第 一 款 自行 车 : 


My first bicycle was a Trek. 


动手 试 一 斌 


请 尝试 编写 一 些 简 短 的 程序 来 完成 下 面 的 练习 ， 以 获得 一 些 使 用 Python 列表 的 第 
一 手 经 验 。 你 可 能 需要 为 每 章 创建 一 个 文件 夹 ， 以 整洁 有 序 的 方式 存储 为 完成 各 章 的 练 
习 而 编写 的 程序 。 

练习 3-1: 姓名 将 一 些 朋友 的 姓名 存储 在 一 个 列表 中 ， 并 将 其 命名 为 names。 依 
次 访问 该 列表 中 的 每 个 元 素 ， 从 而 将 每 个 朋友 的 姓名 打印 出 来 。 


练习 3-2: 问候 语 继续 使 用 练习 3-1 中 的 列表 ， 但 不 打印 每 个 朋友 的 姓名 ， 而 为 
每 人 打印 一 条 消息 。 每 条 消息 都 包含 相同 的 问候 语 ， 但 抬头 为 相应 朋友 的 姓名 。 

练习 3-3: 自己 的 列表 ” 想 想 你 喜欢 的 通勤 方式 ， 如 骑 摩 托 车 或 开 汽 车 ， 并 创建 一 
个 包含 多 种 通勤 方式 的 列表 。 根据 该 列表 打印 一 系列 有 关 这 些 通勤 方式 的 宣言 ， 下 面 是 
一 个 例子 。 


I would like to own a Honda motorcycle. 
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3.2 修改 、 添 加 和 删除 元 素 


你 创建 的 大 多 数列 表 将 是 动态 的 , 这 意味 着 列表 创建 后 , 将 随 着 程序 的 运行 增删 元 素 。 例 如 ， 
你 创建 一 个 游戏 , 要 求 玩家 射 杀 从 天 而 降 的 外 星人 。 为 此 ,可 在 开始 时 将 一 些 外 星人 存储 在 列表 
中 ， 然 后 每 当 有 外 星人 被 射 杀 时 ， 都 将 其 从 列表 中 删除 ， 而 每 次 有 新 的 外 星人 出 现在 屏幕 上 时 ， 
都 将 其 添加 到 列表 中 。 在 整个 游戏 运行 期 间 ， 外 星人 列表 的 长 度 将 不 断 变 化 。 


3.2.1 修改 列表 元 素 


修改 列表 元 素 的 语法 与 访问 列表 元 素 的 语法 类 似 。 要 修改 列表 元 素 , 可 指定 列表 名 和 要 修改 
的 元 素 的 索引 ， 再 指定 该 元 素 的 新 值 。 


例如 ,假设 有 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 'honda'  ， 如 何 修改 它 的 值 呢 ? 


motorcycles.py @ motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


@ motorcycles[0] = 'ducati'’ 
print(motorcycles) 


首先 定义 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 'honda' ( 见 @ )。 接 下 来 ， 将 第 一 个 元 素 的 
值 改 为 'ducati'( 见 @ )。 输 出 表明 ， 第 一 个 元 素 的 值 确实 变 了 ,但 其 他 列表 元 素 的 值 没 变 : 


['honda', 'yamaha', 'suzuki'] 
['ducati', 'yamaha', 'suzuki'] 


你 可 以 修改 任意 列表 元 素 的 值 ， 而 不 仅仅 是 第 一 个 元 素 的 值 。 


3.2.2 ”在 列表 中 添加 元 素 
你 可 能 出 于 众多 原因 要 在 列表 中 添加 新 元 素 。 例 如 ， 你 可 能 希望 游戏 中 出 现 新 的 外 星人 、 添 
加 可 视 化 数据 或 给 网 站 添加 新 注册 的 用 户 。Python 提供 了 多 种 在 既 有 列表 中 添加 新 数据 的 方式 。 
1. 在 列表 未 尾 添加 元 素 


在 列表 中 添加 新 元 素 时 , 最 简单 的 方式 是 将 元 素 附加 (append ) 到 列表 。 给 列表 附加 元 素 时 ， 
它 将 添加 到 列表 末尾 。 继 续 使 用 前 一 个 示例 中 的 列表 ， 在 其 末尾 添加 新 元 素 'ducati ' : 


motorcycles = ['honda', 'yamaha', "Suzuki |] 
print(motorcycles) 


@ motorcycles.append('ducati') 
print(motorcycles) 
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方法 append() 将 元 素 'ducati 添加 到 列表 未 尾 〈 见 @ )， 而 不 影响 列表 中 的 其 他 所 有 元 素 : 


[ honda  ， 'yamaha', 'suzuki'] 
[ honda ， "yamaha ， 'suzuki', "ducati ] 


方法 append() 让 动态 地 创建 列表 易如反掌 。 例 如 ,你 可 以 先 创建 一 个 空 列表 ,再 使 用 一 系列 
函数 调用 append() 来 添加 元 素 。 下 面 来 创建 一 个 空 列表 ， 表 在 其 中 添加 元 素 'honda' 、'yamaha' 
和 'suzuki'; 


motorcycles = [] 


motorcycles.append( "honda ') 
motorcycles.append('yamaha') 
motorcycles.append('suzuki') 


print(motorcycles) 


最 终 的 列表 与 前 述 示 例 中 的 列表 完全 相同 : 


['honda', 'yamaha', 'suzuki'] 


这 种 创建 列表 的 方式 极其 常见 ， 因为 经 常 要 等 程序 运行 后 , 你 才 知道 用 户 要 在 程序 中 存储 哪 
些 数 据 。 为 控制 用 户 ， 可 首先 创建 一 个 空 列表 ,用 于 存储 用 户 将 要 输入 的 值 ， 然 后 将 用 户 提供 的 
每 个 新 值 附 加 到 列表 中 。 


2. 在 列表 中 插入 元 素 
使 用 方法 insert() 可 在 列表 的 任何 位 置 添加 新 元 素 。 为 此 ， 你 需要 指定 新 元 素 的 索引 和 值 。 


motorcycles = ['honda', "yamaha' ， 'suzuki'] 


@ motorcycles.insert(0, 'ducati') 
print(motorcycles) 


在 这 个 示例 中 ,， 值 ' ducati' 被 插入 到 了 列表 开头 ( 见 @ )。 方法 insert() 在 索引 0 处 添加 空 
间 ， 并 将 值 ' ducati' 存 储 到 这 个 地 方 。 这 种 操作 将 列表 中 既 有 的 每 个 元 素 都 右 移 一 个 位 置 : 


['ducati', 'honda', 'yamaha', 'suzuki'] 


3.2.3 ”从 列表 中 删除 元 素 


你 经 常 需 要 从 列表 中 删除 一 个 或 多 个 元 素 。 例如 , 玩家 将 空中 的 一 个 外 星人 射 杀 后 ,你 很 可 
能 要 将 其 从 存活 的 外 星人 列表 中 删除 ; 当 用 户 在 你 创建 的 Web 应 用 中 注销 账户 时 ， 你 就 需要 将 
该 用 户 从 活动 用 户 列 表 中 删除 。 你 可 以 根据 位 置 或 值 来 删除 列表 中 的 元 素 。 
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1. 使 用 del 语句 删除 元 素 
如 果 知 道 要 删除 的 元 素 在 列表 中 的 位 置 ， 可 使 用 del 语句 。 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print (motorcycles) 


@ del motorcycles[0] 
print(motorcycles) 


@ 处 的 代码 使 用 del 删除 了 列表 motorcycles 中 的 第 一 个 元 素 'honda': 


['honda', 'yamaha', 'suzuki'] 
['yamaha' ,'suzuki'] 


使 用 del 可 删除 任意 位 置 处 的 列表 元 素 , 条 件 是 知道 其 索引 。 例如 ， 下 面 演 示 了 如 何 删 除 前 
述 列表 中 的 第 二 个 元 素 'yamaha': 


motorcycles = ['honda', 'yamaha', 'suzuki'|] 
print(motorcycles) 


del motorcycles[1] 
print (motorcycles) 


下 面 的 输出 表明 ,已 经 将 第 二 款 摩托 车 从 列表 中 删除 了 : 


['honda', 'yamaha', 'suzuki'] 
['honda', 'suzuki'] 


在 这 两 个 示例 中 ， 使 用 del 语句 将 值 从 列表 中 删除 后 ， 你 就 无 法 再 访问 它 了 。 


2. 使 用 方法 pop() 删 除 元 素 


有 时 候 ， 你 要 将 元 素 从 列表 中 删除 ， 并 接着 使 用 它 的 值 。 例 如 ， 你 可 能 需要 获取 刚 被 射 杀 的 
外 星人 的 x 坐 标 和 ?7y 坐标, 以 便 在 相应 的 位 置 显示 爆炸 效果 ; 在 Web 应 用 程序 中 , 你 可 能 要 将 用 
户 从 活跃 成 员 列 表 中 删除 ， 并 将 其 加 入 到 非 活 跃 成 员 列 表 中 。 

方法 pop() 删 除 列 表 末 尾 的 元 素 , 并 让 你 能 够 接着 使 用 它 。 术语 弹出 (pop ) 源 自 这 样 的 类 比 : 
列表 就 像 一 个 栈 ， 而 删除 列表 未 尾 的 元 素 相 当 于 弹出 栈 顶 元 素 。 

下 面 来 从 列表 motorcycles 中 弹出 一 款 摩托 车 : 


@ motorcycles = [ honda' ， "yamaha' ， "Suzuki 
print(motorcycles) 


@ popped motorcycle = motorcycles.pop() 
@ print(motorcycles) 
@ print(popped motorcycle) 
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首先 定义 并 打印 列表 motorcycles ( 见 @ )。 接 下 来 ， 从 这 个 列表 中 弹出 一 个 值 ， 并 将 其 赋 给 
变量 popped motorcycle 中 ( 见 @ )。 然 后 打印 这 个 列表 ， 以 核实 从 中 删除 了 一 个 值 ( 见 @ )。 最 
后 打印 弹出 的 值 ， 以 证 明 我 们 依然 能 够 访问 被 删除 的 值 ( 见 @ )。 


输出 表明 ， 列 表 末 尾 的 值 ' suzuki' 已 删除 ， 它 现在 被 赋 给 了 变量 popped_motorcycle: 


['honda', 'yamaha', 'suzuki'] 
['honda' ,'yamaha'] 
suzuki 


方法 pop() 有 什么 用 处 呢 ? 假设 列表 中 的 摩托 车 是 按 购 买 时 间 存储 的 ， 就 可 使 用 方法 pop() 
打印 一 条 消息 ， 指 出 最 后 购买 的 是 哪 款 摩 托 车 : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 


last owned = motorcycles.pop() 
print(f"The last motorcycle I owned was a {last owned.title()}.") 


输出 是 一 个 简单 的 句子 ， 指 出 了 最 新 购买 的 是 哪 款 摩托 车 : 


The last motorcycle I owned was a Suzuki. 


3. 弹出 列表 中 任何 位 置 处 的 元 素 


实际 上 ， 可 以 使 用 pop() 来 删除 列表 中 任意 位 置 的 元 素 ， 只 需 在 圆 括号 中 指定 要 删除 元 素 的 
索引 即 可 。 


motorcycles = ['honda', "yamaha ， 'suzuki'] 


@ first owned = motorcycles.pop(0) 
@ print(f"The first motorcycle I owned was a {first owned.title()}.") 


首先 弹出 列表 中 的 第 一 款 摩 托 车 ( 见 @ )， 然 后 打印 一 条 有 关 这 辆 摩托 车 的 消息 ( 见 @ )。 输 
出 是 一 个 简单 的 句子 ， 描 述 了 我 购买 的 第 一 辆 摩托 车 : 


The first motorcycle I owned was a Honda. 


别 忘 了 ， 每 当 你 使 用 pop() 时 ， 被 弹出 的 元 素 就 不 再 在 列表 中 了 。 


如 果 你 不 确定 该 使 用 del 语句 还 是 pop() 方 法 ， 下 面 是 一 个 简单 的 判断 标准 : 如 果 你 要 从 列 
表 中 删除 一 个 元 素 ， 且 不 再 以 任何 方式 使 用 它 ， 就 使 用 del 语句 ; 如 果 你 要 在 删除 元 素 后 还 能 继 
续 使 用 它 ， 就 使 用 方法 pop()。 
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4. 根据 值 删除 元 素 


有 时 候 ， 你 不 知道 要 从 列表 中 删除 的 值 所 处 的 位 置 。 如 果 只 知道 要 删除 的 元 素 的 值 ， 可 使 用 
方法 remove()。 


例如 ， 假 设 要 从 列表 motorcycles 中 删除 值 ' ducati'。 


motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ motorcycles.remove('ducati') 
print (motorcycles) 


@ 处 的 代码 让 Python 确定 'ducati' 出 现在 列表 的 什么 地 方 ， 并 将 该 元 素 删 除 : 


['honda', 'yamaha', 'suzuki', 'ducati'] 
['honda', 'yamaha', 'suzuki'] 


使 用 remove() 从 列表 中 删除 元 素 时 ,也 可 接着 使 用 它 的 值 。 下 面 删 除 值 ' ducati' 并 打印 一 条 
消息 ， 指 出 要 将 其 从 列表 中 删除 的 原因 : 


@ motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ too expensive = 'ducati' 
@ motorcycles.remove(too expensive) 
print(motorcycles) 
@ print(f"\nA {too expensive.title()} is too expensive for me.") 


定义 列表 ( 见 @ ) 后 ,将 值 'ducati' 赋 给 变量 too expensive ( 见 @ )。 接 下 来 ,使 用 这 个 变 
量 来 告诉 Python 将 哪个 值 从 列表 中 删除 ( 见 @ )。 最 后 ， 值 'ducati 已 经 从 列表 中 删除 ， 但 可 通 
过 变量 too expensive 来 访问 它 ( 见 @ )。 这 让 我 们 能 够 打印 一 条 消息 ， 指 出 将 'ducati' 从 列表 
motorcycles 中 删除 的 原因 : 


[ honda' ， "yamaha ， 'suzuki', 'ducati'] 
[ honda' ， 'yamaha', 'suzuki'] 


A Ducati is too expensive for me. 


注意 方法 remove() 只 删除 第 一 个 指定 的 值 。 如 果 要 删除 的 值 可 能 在 列表 中 出 现 多 次 ， 就 需要 
使 用 循环 来 确保 将 每 个 值 都 删除 。 这 将 在 第 7 章 中 介绍 。 


动手 试 一 试 

下 面 的 练习 比 第 2 章 的 练习 要 复杂 些 , 但 让 你 有 机 会 以 前 面 介绍 过 的 各 种 方式 使 用 
列表 。 

练习 3-4: 嘉宾 名 单 ”如果 你 可 以 邀请 任何 人 一 起 共 进 晚餐 ( 无论 是 在 世 的 还 是 故 
去 的 )， 你 会 邀请 哪些 人 ? 请 创建 一 个 列表 ， 其 中 包 仿 至少 三 个 你 想 邀 请 的 人 ， 然 后 使 
用 这 个 列表 打印 消息 ， 邀 请 这 些 人 来 与 你 共 进 晚餐 。 

练习 3-5: 修改 嘉宾 名 单 ” 你 刚 得 知 有 位 嘉宾 无 法 赴约 ， 因 此 需要 另外 邀请 一 位 嘉宾 。 
口 以 完成 练习 3-4 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 条 print 语句 ,指出 哪 
位 嘉宾 无 法 赴约 。 
口 修改 嘉宾 名 单 ， 将 无 法 赴约 的 嘉宾 的 姓名 替换 为 新 邀请 的 嘉宾 的 姓名 。 
口 再 次 打印 一 系列 消息 ， 向 名 单 中 的 每 位 嘉宾 发 出 邀请 。 


练习 3-6: 添加 嘉宾 ”你 刚 找到 了 一 个 更 大 的 餐桌 ， 可 容纳 更 多 的 嘉宾 。 请 想 想 你 
还 想 邀 请 哪 三 位 嘉宾 。 


口 以 完成 练习 3-4 或 练习 3-5 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 条 piint 语 

多 ， 指 出 你 找到 了 一 个 更 大 的 餐桌 。 

口 使 用 insert() 将 一 位 新 嘉宾 添加 到 名 单 开头 。 

口 使 用 insert() 将 另 一 位 新 嘉宾 添加 到 名 单 中 间 。 

口 使 用 append() 将 最 后 一 位 新 嘉宾 添加 到 名 单 末 尾 。 

口 打印 一 系列 消息 ， 向 名 单 中 的 每 位 嘉宾 发 出 邀请 。 

练习 3-7: 缩减 名 单 ”你 刚 得 知 新 购买 的 餐桌 无 法 及 时 送 达 ， 因 此 只 能 邀请 两 位 嘉宾 

口 以 完成 练习 3-6 时 编写 的 程序 为 基础 ,在 程序 末尾 添加 一 行 代 码 , 打印 一 条 你 

能 邀请 两 位 嘉宾 共 进 晚餐 的 消息 。 

口 使 用 pop() 不 断 地 删除 名 单 中 的 嘉宾 ,直到 只 有 两 位 嘉宾 为 止 。 每 次 从 名 单 中 弹 
出 一 位 嘉宾 时 ， 都 打印 一 条 消息 ， 让 该 嘉宾 知悉 你 很 抱歉 ， 无 法 邀请 他 来 共 进 
晚餐 。 

口 对 于 余下 两 位 嘉宾 中 的 每 一 位 ， 都 打印 一 条 消息 ， 指 出 他 依然 在 受 邀 人 之 列 。 

口 使 用 del 将 最 后 两 位 嘉宾 从 名 单 中 删除 ， 让 名 单 变 成 空 的 。 打 印 该 名 单 ， 核 实 

程序 结束 时 名 单 确实 是 空 的 。 


3.3 ”组织 列表 


在 你 创建 的 列表 中 , 元 素 的 排列 顺序 常常 是 无 法 预测 的 , 因为 你 并 非 总 能 控制 用 户 提供 数据 
的 顺序 。 这 虽然 在 大 多 数 情况 下 是 不 可 避免 的 ， 但 你 经 常 需要 以 特定 的 顺序 呈现 信息 。 有 时 候 ， 
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你 希望 保留 列表 元 素 最 初 的 排列 顺序 , 而 有 时 候 又 需要 调整 排列 顺序 。Python 提供 了 很 多 组 织 列 
表 的 方式 ， 可 根据 具体 情况 选用 。 
3.3.1 使 用 方法 sort() 对 列表 永久 排序 


Python 方法 sort() 让 你 能 够 较为 轻松 地 对 列表 进行 排序 。 假 设 你 有 一 个 汽车 列表 , 并 要 让 其 
中 的 汽车 按 字母 顺序 排列 。 为 简化 这 项 任务 ,假设 该 列表 中 的 所 有 值 都 是 小 写 的 。 


cars.py Cars = ['bmw', "audi', 'toyota', 'subaru'] 
@ cars.sort() 
print(cars) 


方法 sort()( 见 @ ) 永久 性 地 修改 列表 元 素 的 排列 顺序 。 现 在 ,汽车 是 按 字母 顺序 排列 的 ， 
青 也 无 法 恢复 到 原来 的 排列 顺序 : 


['audi', 'bmw', 'subaru', 'toyota'] 


还 可 以 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 只 需 向 sort() 方 法 传递 参数 reverse=True 
即 可 。 下 面 的 示例 将 汽车 列表 按 与 字母 顺序 相反 的 顺序 排列 : 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
cars.sort(reverse=True) 
print(cars) 


同样 ， 对 列表 元 素 排列 顺序 的 修改 是 永久 性 的 : 


['toyota', 'subaru'’, 'bmw', 'audi'] 


3.3.2 ”使 用 函数 sorted() 对 列表 临时 排序 


要 保留 列表 元 素 原来 的 排列 顺序 ， 同 时 以 特定 的 顺序 呈现 它们 , 可 使 用 函数 sorted()。 函 数 
sorted() 让 你 能 够 按 特定 顺序 显示 列表 元 素 ， 同 时 不 影响 它们 在 列表 中 的 原始 排列 顺序 。 


下 面 尝试 来 对 汽车 列表 调用 这 个 函数 。 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 


@ print("Here is the original list:") 
print(cars) 


@ print("\nHere is the sorted list:") 
print(sorted(cars)) 


©@ print("\nHere is the original list again:") 
print(cars) 
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首先 按 原始 顺序 打印 列表 ( 见 @ )， 再 按 字 母 顺序 显示 该 列表 ( 见 @ )。 以 特定 顺序 显示 列表 
后 ,我 们 进行 核实 ， 确 认 列 表 元 素 的 排列 顺序 与 以 前 相同 ( 见 @ )。 


Here is the original list: 
‘bmw' , "audi', 'toyota', 'subaru'] 


Here is the sorted list: 
'audi', 'bmw', 'subaru', 'toyota'] 


@ Here is the original list again: 
'bmw', "audi', 'toyota', 'subaru'] 


注意 ， 调 用 函数 sorted() 后 ， 列 表 元 素 的 排列 顺序 并 没有 变 ( 见 @ )。 如 果 要 按 与 字母 顺序 
相反 的 顺序 显示 列表 ， 也 可 向 函数 sorted() 传 递 参数 reverse=True。 


注意 在 并 非 所 有 的 值 都 是 小 写 时 ， 按 字母 顺序 排列 列表 要 复杂 些 。 决 定 排列 顺序 时 ， 有 多 种 
解读 大 写字 母 的 方式 ， 要 指定 准确 的 排列 顺序 ， 可 能 比 我 们 这 里 所 做 的 要 复杂 。 然 而 ， 
大 多 数 排序 方式 是 以 本 节 介 绍 的 知识 为 基础 的 。 


3.3.3” 倒 着 打印 列表 


要 反 转 列表 元 素 的 排列 顺序 ， 可 使 用 方法 reverse()。 假 设 汽车 列表 是 按 购买 时 间 排 列 的 ， 
可 轻松 地 按 相反 的 顺序 排列 其 中 的 汽车 : 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
print(cars) 


cars.reverse() 
print(cars) 


注意 ，reverse() 不 是 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 而 只 是 反 转 列表 元 素 的 排列 
顺序 : 


['bmw', 'audi', 'toyota', 'subaru'] 
['subaru', 'toyota', 'audi', "bmw'] 


方法 reverse() 永 久 性 地 修改 列表 元 素 的 排列 顺序 ， 但 可 随时 恢复 到 原来 的 排列 顺序 ， 只 需 
对 列表 再 次 调用 reverse() 即 可 。 
3.3.4 ”确定 列表 的 长 度 


使 用 函数 len() 可 快速 获悉 列表 的 长 度 。 在 下 面 的 示例 中 ， 列 表 包 含 四 个 元 素 ， 因 此 其 长 度 
为 4: 
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>>> cars = ['bmw', 'audi', 'toyota', 'subaru'] 
>>> len(cars) 
4 


需要 完成 如 下 任务 时 ，len() 很 有 用 : 明确 还 有 多 少 个 外 星人 未 被 射 杀 ， 确 定 需要 管理 多 少 
项 可 视 化 数据 ， 计 算 网 站 有 多 少 注册 用 户 ， 等 等 。 


注意 Python 计算 列表 元 素数 时 从 1 开始 ， 因 此 确定 列表 长 度 时 ， 你 应 该 不 会 遇 到 差 一 错误 。 


动手 试 一 斌 
练习 3-8: 放眼 世界 想 出 至 少 5 个 你 渴望 去 旅游 的 地 方 。 
口 将 这 些 地 方 存 储 在 一 个 列表 中 ， 并 确保 其 中 的 元 素 不 是 按 字母 顺序 排列 的 。 
口 按 原始 排列 顺序 打印 该 列表 。 不 要 考虑 输出 是 否 整 洁 的 问题 ， 只 管 打 印 原 始 
Python 列表 。 
口 使 用 sorted() 按 字母 顺序 打印 这 个 列表 ， 同 时 不 要 修改 它 。 
口 再 次 打印 该 列表 ， 核 实 排 列 顺序 未 变 。 
口 使 用 sorted() 按 与 字母 顺序 相反 的 顺序 打印 这 个 列表 ， 同 时 不 要 修改 它 。 
口 再 次 打印 该 列表 ， 核 实 排列 顺序 未 变 。 
口 使 用 feverse() 修 改 列表 元 素 的 排列 顺序 。 打 印 该 列表 ， 核 实 排列 顺序 确实 变 了 。 
口 使 用 feverse() 再 次 修改 列表 元 素 的 排列 顺序 。 打 印 该 列表 ， 核 实 已 恢复 到 原来 
的 排列 顺序 。 
口 使 用 sort() 修 改 该 列表 ， 使 其 元 素 按 字 母 顺序 排列 。 打 印 该 列表 ， 核 实 排列 顺 
序 确实 变 了 。 
口 使 用 sort() 修 改 该 列表 , 使 其 元 素 按 与 字母 顺序 相反 的 顺序 排列 。 打 印 该 列表 ， 
核实 排列 顺序 确实 变 了 。 

练习 3-9: 晚餐 嘉宾 在 完成 练习 3-4~ 练 习 3-7 时 编写 的 程序 之 一 中 ,使 用 len() 
打印 一 条 消息 ， 指 出 你 邀请 了 多 少 位 嘉宾 来 共 进 晚餐 。 

练习 3-10: 尝试 使 用 各 个 函数 ” 想 想 可 存储 到 列表 中 的 东西 ， 如 山川 、 河 流 、 国 家 、 
城市 、 语 言 或 你 喜欢 的 任何 东西 。 编 写 一 个 程序 , 在 其 中 创建 一 个 包含 这 些 元 素 的 列表 ， 
然后 ， 对 于 本 章 介 绍 的 每 个 函数 ， 都 至 少 使 用 一 次 来 处 理 这 个 列表 。 


3.4 ”使 用 列表 时 避免 索引 错误 
刚 开始 使 用 列表 时 ,经 常会 遇 到 一 种 错误 。 假 设 你 有 一 个 包含 三 个 元 素 的 列表 , 却 要 求 获取 
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第 四 个 元 素 : 


motorcycles.py motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles[3]) 


这 将 导致 索引 错误 : 


Traceback (most recent call last): 
File "motorcycles.py", line 2, in <module> 
print(motorcycles[3]) 
IndexError: list index out of range 


Python 试图 向 你 提供 位 于 索引 3 处 的 元 素 ， 但 它 搜索 列表 motorcycles 时 ， 却 发 现 索 引 3 处 
没有 元 素 。 鉴 于 列表 索引 差 一 的 特征 ， 这 种 错误 很 常见 。 有 些 人 从 1 开始 数 ， 因 此 以 为 第 三 个 元 
素 的 索引 为 3。 然 而 在 Python 中 ， 第 三 个 元 素 的 索引 为 2， 因 为 索引 是 从 0 开始 的 。 


索引 错误 意味 着 Python 在 指定 索引 处 找 不 到 元 素 。 程 序 发 生 索 引 错 误 时 ， 请 尝试 将 指定 的 
索引 减 1， 然 后 再 次 运行 程序 ， 看 看 结果 是 否 正确 。 

别 忘 了 , 每 当 需 要 访问 最 后 一 个 列表 元 素 时 , 都 可 使 用 索引 -1。 这 在 任何 情况 下 都 行 之 有 效 ， 
即便 你 最 后 一 次 访问 列表 后 ， 其 长 度 发 生 了 变化 : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles[-1]) 


索引 -1 总 是 返回 最 后 一 个 列表 元 素 ， 这 里 为 值 ' suzuki': 


"suzuki" 


仅 当 列表 为 空 时 ， 这 种 访问 最 后 一 个 元 素 的 方式 才 会 导致 错误 : 


motorcycles = [] 
print(motorcycles[-1]) 


列表 motorcycles 不 包含 任何 元 素 ， 因 此 Python 返回 一 条 索引 错误 消息 : 


Traceback (most recent call last): 
File "motorcyles.py", line 3, in <module> 
print(motorcycles[-1]) 
IndexError: list index out of range 


注意 发 生 索 引 错 误 却 找 不 到 解决 办 法 时 ， 请 尝试 将 列表 或 其 长 度 打印 出 来 。 列 表 可 能 与 你 以 
为 的 规 然 不 同 ， 在 程序 对 其 进行 了 动态 处 理 时 尤其 如 此 。 通 过 查看 列表 或 其 包含 的 元 素 
数 ， 可 帮助 你 找 出 这 种 逻辑 错误 。 
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动手 试 一 试 
练习 3-11: 有 意 引发 错误 ”如 果 你 还 没有 在 程序 中 遇 到 过 索引 错误 ,就 尝试 引发 一 


个 这 种 错误 。 在 你 的 一 个 程序 中 ,修改 其 中 的 索引 ,以 引发 索引 错误 。 关 闭 程序 前 , 务 
必 消 除 这 个 错误 。 


3.5 小结 


在 本 章 中 , 你 学 习 了 : 列表 是 什么 以 及 如 何 使 用 其 中 的 元 素 ; 如 何 定义 列表 以 及 如 何 增删 元 
素 ; 如 何 对 列表 进行 永久 性 排序 ， 以 及 如 何 为 展示 列表 而 进行 临时 排序 ;如 何 确 定 列表 的 长 度 ， 
以 及 在 使 用 列表 时 如 何 避 免 索引 错误 。 


在 第 4 章 , 你 将 学 习 如 何以 更 高 效 的 方式 处 理 列 表 元 素 。 通 过 使 用 为 数 不 多 的 几 行 代码 来 遍 
历 列表 元 素 ， 你 就 能 高 效 地 处 理 它 们 ， 即 便 列 表 包 含 数 千 乃至 数 百 万 个 元 素 。 


操作 列表 


在 第 3 章 , 你 学 习 了 如 何 创 建 简单 的 列表 , 还 学 习 了 如 何 操 作 列 
表 元 素 。 在 本 章 中 ,你 将 学 习 如 何人 遍历 整个 列表 , 这 只 需要 几 行 代码 ， 
无 论 列表 有 多 长 ,循环 让 你 能 够 对 列表 的 每 个 元 素 部 采取 一 个 或 一 系 
列 相 同 的 措施 , 从 而 高 效 地 处 理 任何 长 度 的 列表 ,包括 包含 数 千 乃至 
数 百 万 个 元 素 的 列表 。 


4.1 遍历 整个 列表 


你 经 党 需要 遍历 列表 的 所 有 元 素 ， 对 每 个 元 素 执 行 相同 的 操作 。 例如， 在 游戏 中 ,可 能 需要 
将 每 个 界面 元 素平 移 相 同 的 距离 ; 对 于 包含 数字 的 列表 , 可 能 需要 对 每 个 元 素 执 行 相同 的 统计 运 
算 ; 在 网 站 中 ,可 能 需要 显示 文章 列表 中 的 每 个 标题 。 需 要 对 列表 中 的 每 个 元 素 都 执行 相同 的 操 
作 时 ， 可 使 用 Python 中 的 for 循环 。 

假设 我 们 有 一 个 魔术 师 名 单 , 需要 将 其 中 每 个 魔术 师 的 名 字 都 打印 出 来 。 为 此 ， 可 以 分 别 获 
取 名 单 中 的 每 个 名 字 , 但 这 种 做 法 会 导致 多 个 问题 。 例 如 ， 如 果 名 单 很 长 ， 将 包含 大 量 重复 的 代 
码 。 另 外 ,每 当 名 单 的 长 度 发 生变 化 时 ， 都 必须 修改 代码 。 通 过 使 用 for 循环 ， 可 以 让 Python 
去 处 理 这 些 问题 。 


下 面 使 用 for 循环 来 打印 魔术 师 名 单 中 的 所 有 和 名字: 


magicians.py @ magicians = ['alice', 'david', 'carolina'] 
@ for magician in magicians: 
(3 print(magician) 


首先 ， 像 第 3 章 那样 定义 一 个 列表 ( 见 @ )。 接 下 来 ,定义 一 个 for 循环 ( 见 @ )。 这 行 代码 
让 Python 从 列表 magicians 中 取出 一 个 名 字 ， 并 将 其 与 变量 magician 相关 联 。 最 后 ， 让 Python 


4.1 遍历 整个 列表 43 


打印 前 面 赋 给 变量 magician 的 名 字 ( 见 @ )。 这 样 ， 对 于 列表 中 的 每 个 名 字 ，Python 都 将 重复 执 
行 @ 处 和 @ 人 处 的 代码 行 。 你 可 以 这 样 解读 这 些 代码 : 对 于 列表 magicians 中 的 每 位 魔术 师 ， 都 将 
其 名 字 打 印 出 来 。 输 出 很 简单 ， 就 是 列表 中 所 有 的 名 字 : 


alice 
david 
carolina 


4.1.1 深入 研究 循环 


循环 这 种 概念 很 重要 ， 因 为 它 是 让 计算 机 自动 完成 重复 工作 的 常见 方式 之 一 。 例如 , 在 前 面 
magicians.py 中 使 用 的 简单 循环 里 ，Python 将 首先 读 取 其 中 的 第 一 行 代 码 : 


for magician in magicians: 


这 行 代码 让 Python 获取 列表 magicians 中 的 第 一 个 值 'alice' ， 并 将 其 与 变量 magician 相关 
联 。 接 下 来 ，Python 读 取 下 一 行 代码 : 


print(magician) 


它 让 Python 打印 magician 的 值 , 依然 是 'alice' 。 鉴 于 该 列表 还 包含 其 他 值 ，Python 返回 到 
循环 的 第 一 行 : 


for magician in magicians: 


Python 获取 列表 中 的 下 一 个 名 字 'david' ， 并 将 其 与 变量 magician 相关 联 ， 再 执行 下 面 这 行 
代码 : 


print(magician) 


Python 再 次 打印 变量 magician 的 值 ， 当 前 为 'david'。 接 下 来 ，Python 再 次 执行 整个 循环 ， 
对 列表 中 的 最 后 一 个 值 'carolina' 进行 处 理 。 至 此 , 列表 中 没有 其 他 的 值 了 ， 因 此 Python 接着 执 
行程 序 的 下 一 行 代码 。 在 这 个 示例 中 ，for 循环 后 面 没有 其 他 代码 ， 因 此 程序 就 此 结束 。 


刚 开 始 使 用 循环 时 请 牢记 ,对 列表 中 的 每 个 元 素 ， 都 将 执行 循环 指定 的 步骤 ， 而 不 管 列表 包 
含 多 少 个 元 素 。 如 果 列 表 包 含 一 百 万 个 元 素 , Python 就 重复 执行 指定 的 步 又 一 百 万 次 , 且 通 常 速 
度 非 常 快 。 

另外 , 编写 for 循环 时 , 可 以 给 依次 与 列表 中 每 个 值 相关 联 的 临时 变量 指定 任意 名 称 。 然而 ， 
选择 描述 单个 列表 元 素 的 有 意义 名 称 大 有 神 益 。 例 如 ， 对 于 小 猫 列表 、 小 狗 列表 和 一 般 性 列表 ， 
像 下 面 这 样 编写 for 循环 的 第 一 行 代码 是 不 错 的 选择 : 
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for cat in cats: 
for dog in dogs: 
for item in list of items: 


这 些 命名 约定 有 助 于 你 明白 for 循环 中 将 对 每 个 元 素 执行 的 操作 。 使 用 单数 和 复数 式 名 称 ， 
可 帮助 你 判断 代码 段 处 理 的 是 单个 列表 元 素 还 是 整个 列表 。 


4.1.2 在 for 循环 中 执行 更 多 操作 


在 for 循环 中 ， 可 对 每 个 元 素 执行 任何 操作 。 下 面 来 扩展 前 面 的 示例 ， 对 于 每 位 魔术 师 ， 都 
打印 一 条 消息 ， 指 出 他 的 表演 大 精彩 了 。 


magicians.py Magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
@ print(f"{magician.title()}, that was a great trick!") 


相 比 于 前 一 个 示例 ,唯一 的 不 同 是 为 每 位 魔术 师 打 印 了 一 条 以 其 名 字 为 抬头 的 消息 ( 见 @ )。 
这 个 循环 第 一 次 迭代 时 ， 变量 magician 的 值 为 'alice' ， 因 此 Python 打印 的 第 一 条 消息 的 抬头 为 
'Alice' ; 第 二 次 迭代 时 ， 消 息 的 抬头 为 'David' ; 第 三 次 迭代 时 ， 抬 涉 为 'Carolina'。 

下 面 的 输出 表明 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 打印 了 一 条 个 性 化 消息 


CD: 


Alice, that was a great trick! 
David, that was a great trick! 
Carolina, that was a great trick! 


在 for 循环 中 ， 想 包含 多 少 行 代码 都 可 以 。 在 代码 行 for magician in magicians 后 面 ， 每 
个 缩 进 的 代码 行 都 是 循环 的 一 部 分 , 将 针对 列表 中 的 每 个 值 都 执行 一 次 。 因 此 ， 可 对 列表 中 的 每 
个 值 执行 任意 次 数 的 操作 。 


下 面 再 添加 一 行 代码 ， 告 诉 每 位 魔术 师 ， 我 们 期 待 他 的 下 一 次 表演 : 


magicians = ['alice', 'david', 'carolina'| 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
© print(f"I can't wait to see your next trick, {magician.title()}.\n") 


两 个 函数 调用 print() 都 缩 进 了 ， 因 此 它们 都 将 针对 列表 中 的 每 位 魔术 师 执行 一 次 。 第 二 个 
函数 调用 print() 中 的 换行 符 "\n" ( 见 @ ) 在 每 次 迭代 结束 后 都 插入 一 个 空 行 ， 从 而 整洁 地 将 针 
对 各 位 魔术 师 的 消息 编组 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 
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David, that was a great trick! 
I can't wait to see your next trick, David. 


Carolina, that was a great trick! 
I can't wait to see your next trick, Carolina. 


在 for 循环 中 ,， 想 包含 多 少 行 代码 都 可 以 。 实 际 上 ， 你 会 发 现 使 用 for 循环 对 每 个 元 素 执行 
众多 不 同 的 操作 很 有 用 。 


4.1.3 在 for 循环 结束 后 执行 一 些 操 作 
for 循环 结束 后 怎么 办 呢 ? 通常 ， 你 需要 提供 总 结 性 输出 或 接着 执行 程序 必须 完成 的 其 他 任务 。 


在 for 循环 后 面 ， 没 有 缩 进 的 代码 都 只 执行 一 次 ,不 会 重复 执行 。 下 面 来 打印 一 条 向 全 体 魔 
术 师 致谢 的 消息 , 感谢 他 们 的 精彩 表演 。 想 要 在 打印 给 各 位 魔术 师 的 消息 后 面 打 印 一 条 给 全 体 魔 
术 师 的 致谢 消息 ， 需 要 将 相应 的 代码 放 在 for 循环 后 面 ， 且 不 缩 进 : 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
print(f"I can't wait to see your next trick, {magician.title()}.\n") 


@ print("Thank you, everyone. That was a great magic show!") 


你 在 前 面 看 到 了 ， 开 头 两 个 函数 调用 print() 针 对 列表 中 的 每 位 魔术 师 重复 执行 。 然 而 ， 第 
三 个 函数 调用 print() 没 有 缩 进 ( 见 @ )， 因 此 只 执行 一 次 : 


Alice, that was a great trick! 
can't wait to see your next trick, Alice. 


David, that was a great tric 
can't wait to see your next trick, David. 


Carolina, that was a great trick! 
can't wait to see your next trick, Carolina. 


Thank you, everyone. That was a great magic show! 


使 用 for 循环 处 理 数据 是 一 种 对 数据 集 执 行 整体 操作 的 不 错 方式 。 例 如 ， 你 可 能 使 用 for 循 
环 来 初始 化 游戏 : 遍历 角色 列表 , 将 每 个 角色 显示 到 屏幕 上 。 然 后 在 循环 后 面 添加 一 个 不 缩 进 的 
代码 块 ， 在 屏幕 上 绘制 所 有 角色 后 显示 一 个 Play Now 按钮 。 


4.2 ”避免 缩 进 错误 
Python 根据 缩 进来 判断 代码 行 与 前 一 个 代码 行 的 关系 。 在 前 面 的 示例 中 , 向 各 位 魔术 师 显 示 
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消息 的 代码 行 是 for 循环 的 一 部 分 ， 因 为 它们 缩 进 了 。Python 通过 使 用 缩 进 让 代码 更 易 读 。 简 单 
地 说 ， 它 要 求 你 使 用 缩 进 让 代码 整洁 而 结构 清晰 。 在 较 长 的 Python 程序 中 ， 你 将 看 到 缩 进程 度 
各 不 相同 的 代码 块 ， 从 而 对 程序 的 组 织 结 构 有 大 致 的 认识 。 


开始 编写 必须 正确 缩 进 的 代码 时 , 需要 注意 一 些 常见 的 缩 进 错误 。 例 如, 程序 员 有 时 候 会 将 
不 需要 缩 进 的 代码 块 缩 进 , 而 对 于 必须 缩 进 的 代码 块 却 忘 了 缩 进 。 查 看 这 样 的 错误 示例 有 助 于 你 
以 后 避 开 它们 ， 以 及 在 它们 出 现在 程序 中 时 进行 修复 。 


下 面 来 看 一 些 较为 常见 的 缩 进 错误 。 


4.2.1 忘记 缩 进 
对 于 位 于 for 语句 后 面 且 属于 循环 组 成 部 分 的 代码 行 , 一 定 要 缩 进 。 如 果 忘 记 缩 进 ，Python 


会 提醒 你 : 


magicians.py magicians = ['alice'’, 'david', 'carolina'] 
for magician in magicians: 
@ print(magician) 


函数 调用 print()( 见 @ ) 应 缩 进 却 没 有 缩 进 。Python 没有 找到 期 望 缩 进 的 代码 块 时 ， 会 让 
你 知道 哪 行 代 码 有 问题 。 


File "magicians.py", line 3 
print (magician) 
人 


IndentationError: expected an indented block 


通常 ， 将 紧 跟 在 for 语句 后 面 的 代码 行 缩 进 ， 可 消除 这 种 缩 进 错误 。 


4.2.2 ”忘记 缩 进 额外 的 代码 行 

有 了 时候 , 循环 能 够 运行 且 不 会 报告 错误 , 但 结果 可 能 出 人 意料 。 试图 在 循环 中 执行 多 项 任务 ， 
却 忘 记 缩 进 其 中 的 一 些 代码 行 时 ， 就 会 出 现 这 种 情况 。 

例如 ， 如 果 忘 记 缩 进 循环 中 的 第 二 行 代码 ( 它 告诉 每 位 魔术 师 ， 我 们 期 待 其 下 次 表演 )， 就 
会 出 现 这 种 情况 : 


magicians = ["alice'， 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
@ print(f"I can't wait to see your next trick, {magician.title()}.\n") 


第 二 个 函数 调用 print()( 见 @ ) 原本 需要 缩 进 ， 但 Python 发 现 for 语句 后 面 有 一 行 代 码 是 
缩 进 的 ， 因 此 没有 报告 错误 。 最 终 的 结果 是 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 执行 了 第 一 个 函数 调 
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用 print(), 因为 它 缩 进 了 ; 而 第 二 个 函数 调用 print() 没 有 缩 进 , 因此 只 在 循环 结束 后 执行 一 次 。 
由 于 变量 magician 的 终 值 为 'carolina' ,结果 只 有 她 收 到 了 消息 “looking forward to the nexttrick”: 


Alice, that was a great trick! 

David, that was a great trick! 

Carolina, that was a great trick! 

I can't wait to see your next trick, Carolina. 


这 是 一 个 逻辑 错误 。 从 语法 上 看 ， 这 些 Python 代码 是 合法 的 ， 但 由 于 存在 逻辑 错误 ， 结 果 
并 不 符合 预期 。 如 果 你 预期 某 项 操作 将 针对 每 个 列表 元 素 都 执行 一 次 ， 但 它 总 共 只 执行 了 一 次 ， 
请 确定 需要 将 一 行 还 是 多 行 代码 缩 进 。 


4.2.3 不 必要 的 缩 进 
如 果 你 不 小 心 缩 进 了 无 须 缩 进 的 代码 行 ，Python 将 指出 这 一 点 


hello world.py message = "Hello Python world!" 
© print(message) 


函数 调用 print() ( 见 @ ) 无 须 缩 进 ， 因 为 它 并 非 循环 的 组 成 部 分 。 因 此 Python 将 指出 这 种 
错误 : 


File "hello world.py", line 2 
print(message) 


IndentationError: unexpected indent 


为 避免 意外 缩 进 错误 ， 请 只 缩 进 需要 缩 进 的 代码 。 在 前 面 编写 的 程序 中 ， 只 有 要 在 for 循环 
中 对 每 个 元 素 执行 的 代码 需要 缩 进 


4.2.4 循环 后 不 必要 的 缩 进 


进 了 应 在 循环 结束 后 执行 的 代码 , 这 些 代码 将 针对 每 个 列表 元 素 重 复 执行。 在 
有 些 情况 下 ， 能 导致 Python 报告 语法 错误 ,但 在 大 多 数 情 况 下 ， 这 只 会 导致 逻辑 错误 。 


例如 ， 如 果 不 小 心 缩 进 了 感谢 全 体 魔术 师 精 彩 表 演 的 代码 行 ， 结 果 将 如 何 呢 ? 


magicians.py magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
print(f"I can't wait to see your next trick, {magician.title()}.\n") 


© print("Thank you everyone, that was a great magic show!") 


48 第 4 章 操作 列表 


由 于 @ 处 的 代码 行 缩 进 了 ， 它 将 针对 列表 中 的 每 位 魔术 师 执 行 一 次 ， 如 下 所 示 : 


Alice, that was a great trick! 
can't wait to see your next trick, Alice. 


Thank you everyone, that was a great magic show! 
David, that was a great trick! 
can't wait to see your next trick, David. 


Thank you everyone, that was a great magic show! 
Carolina, that was a great trick! 
can't wait to see your next trick, Carolina. 


Thank you everyone, that was a great magic show! 


这 也 是 一 个 逻辑 错误 , 与 4.2.2 节 的 错误 类 似 。Python 不 知道 你 的 本 意 ， 只 要 代码 符合 语法 ， 
它 就 会 运行 。 如 果 原 本 只 应 执行 一 次 的 操作 执行 了 多 次 ， 可 能 要 对 执行 该 操作 的 代码 取消 缩 进 。 


4.2.5 遗漏 了 冒号 


for 语句 末尾 的 冒号 告诉 Python， 下 一 行 是 循环 的 第 一 行 。 


magicians = ["alice'，'david'， 'carolina'] 
@ for magician in magicians 
print (magician) 


如 果 不 小 心 遗 漏 了 冒号 ， 如 @ 所 示 ， 将 导致 语法 错误 ， 因 为 Python 不 知道 你 意欲 何 为 。 这 
种 错误 虽然 易于 消除 , 但 并 不 那么 容易 发 现 。 程序 员 为 找 出 这 样 的 单字 符 错误 ,花费 的 时 间 多 得 
令 人 惊讶 。 此 类 错误 之 所 以 难以 发 现 ， 是 因为 通常 在 人 们 的 意料 之 外 。 


动手 试 一 斌 
练习 4-1: 比萨 ” 想 出 至 少 三 种 你 喜欢 的 比萨 ， 将 其 名 称 存 储 在 一 个 列表 中 ， 再 使 
用 for 循环 将 每 种 比萨 的 名 称 打 印 出 来 。 


口 修改 这 个 for 循环 ， 使 其 打印 包含 比萨 名 称 的 句子 ， 而 不 仅仅 是 比萨 的 名 称 。 


对 于 每 种 比萨 ， 都 显示 一 行 输出 ， 下 面 是 一 个 例子 。 
Ilike pepperoni pizza. 
口 在 程序 末尾 添加 一 行 代码 ， 它 不 在 for 循环 中 ， 指 出 你 有 多 喜欢 比萨 。 输 出 应 
包含 针对 每 种 比萨 的 消息 ， 还 有 一 个 总 结 性 句子 ， 下 面 是 一 个 例子 。 
I really love pizza! 


4.3 创建 数值 列表 49 


练习 4-2: 动物 想 出 至 少 三 种 有 共同 特征 的 动物 ， 将 其 名 称 存 储 在 一 个 列表 中 ， 
再 使 用 for 循环 将 每 种 动物 的 名 称 打 印 出 来 。 


口 修改 这 个 程序 ,使 其 针对 每 种 动物 都 打印 一 个 句子 ， 下 面 是 一 个 例子 。 
A dog would make a great pet. 
口 在 程序 末尾 添加 一 行 代码 ， 指 出 这 些 动物 的 共同 之 处 ， 如 打印 下 面 这 样 的 句子 。 


Any of these animals would make a great pet! 


4.3 创建 数值 列表 


需要 存储 一 组 数 的 原因 有 很 多 。 例 如 , 在 游戏 中 ,需要 跟踪 每 个 角色 的 位 置 ， 还 可 能 需要 跟 
踪 玩 家 的 几 个 最 高 得 分 ; 在 数据 可 视 化 中 ,处 理 的 几乎 都 是 由 数 ( 如 温度 、 距 离 、 人 口 数量 、 经 
度 和 纬度 等 ) 组 成 的 集合 。 

列表 非常 适合 用 于 存储 数字 集合 ， 而 Python 提供 了 很 多 工具 ， 可 帮助 你 高 效 地 处 理 数字 列 
表 。 明 白 如 何 有 效 地 使 用 这 些 工 具 后 ， 即 便 列 表 包 含 数 百 万 个 元 素 ， 你 编写 的 代码 也 能 运行 得 
很 好 。 


4.3.1 使 用 函数 range() 


Python 函数 range() 让 你 能 够 轻松 地 生成 一 系列 数 。 例 如, 可 以 像 下 面 这 样 使 用 函数 fange() 
来 打印 一 系列 数 : 


first” for value in range(1, 5): 
numbers.py print(value) 


上 述 代码 好 像 应 该 打印 数 1 ~ 5， 但 实际 上 不 会 打印 5: 


入 DP 


在 这 个 示例 中 , range() 只 打印 数 1 ~4。 这 是 编程 语言 中 常见 的 差 一 行为 的 结果 。 函数 range() 
让 Python 从 指定 的 第 一 个 值 开始 数 ， 并 在 到 达 你 指定 的 第 二 个 值 时 停止 。 因 为 它 在 第 二 个 值 处 
停止 ， 所 以 输出 不 包含 该 值 ( 这 里 为 5 )。 

要 打印 数 1 ~5， 需 要 使 用 range(1,6): 


for value in range(1, 6): 
print(value) 


50 第 4 章 操作 列表 


这 样 ， 输 出 将 从 1 开始、 到 5 结 


MODOP 


使 用 range() 时 ， 如 果 输 出 不 符合 预期 ， 请 尝试 将 指定 的 值 加 1 或 减 1。 
调用 函数 range() 时 , 也 可 只 指定 一 个 参数 ， 这样 它 将 从 0 开始 。 例 如 ,range(6) 返 回 数 0 ~5。 


4.3.2 ”使 用 range() 创 建 数字 列表 


要 创建 数字 列表 ， 可 使 用 函数 1ist() 将 range() 的 结果 直接 转换 为 列表 。 如 果 将 range() 作 
为 list() 的 参数 ,输出 将 是 一 个 数字 列表 。 


在 前 一 节 的 示例 中 ， 只 是 将 一 系列 数 打印 出 来 。 要 将 这 组 数 转换 为 列表 ， 可 使 用 list(): 


numbers = list(range(1, 6)) 
print(numbers) 


[i 2 3 3] 


使 用 函数 range() 时 ， 还 可 指定 步 长 。 为 此 ， 可 给 这 个 函数 指定 第 三 个 参数 ，Python 将 根据 
这 个 步 长 来 生成 数 。 
例如 ， 下 面 的 代码 打印 1 ~ 10 的 偶数 : 


even_numbers.py even numbers = list(range(2, 11, 2)) 
print(even numbers) 


在 这 个 示例 中 ， 函 数 range() 从 2 开始 数 ， 然 后 不 断 加 2， 直 到 达到 或 超过 终 值 ( 11 )， 因 此 
输出 如 下 : 


[2, 4, 6, 8, 10] 


使 用 函数 range() 几 乎 能 够 创建 任何 需要 的 数 集 。 例 如 ， 如 何 创建 一 个 列表 ， 其 中 包含 前 10 
个 整数 (1~ 10 ) 的 平方 呢 ? 在 Python 中 ， 用 两 个 星 号 ( ** ) 表示 乘 方 运算 。 下 面 的 代码 演示 了 
如 何 将 前 10 个 整数 的 平方 加 入 一 个 列表 中 : 


squares.py © SqUares = [] 
@ for value in range(1, 11): 
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3 square = Value ** 2 
@ squares.append(square) 


©@ print(squares) 


首先 , 创建 一 个 名 为 squares 的 空 列表 ( 见 @ )。 接 下 来 ， 使 用 函数 range() 让 Python 遍历 1 ~ 
10 的 值 ( 见 @ ), 在 循环 中 , 计算 当前 值 的 平方 ， 并 将 结果 赋 给 变量 square ( 见 @ ),。 然后 ,将 新 计 
算得 到 的 平方 值 附加 到 列表 squares 末尾 ( 见 @ )。 最后， 循环 结束 后 ， 打 印 列表 squares ( 见 日 ): 


[1, 4, 9, 16, 25, 36, 49, 64, 81, 100] 


为 了 让 代码 更 简洁 ， 可 不 使 用 临时 变量 square， 而 直接 将 每 个 计算 得 到 的 值 附加 到 列表 
末尾 : 


squares = [|] 
for value in range(1,11): 
@ squares.append(value**2) 


print(squares) 


@ 处 的 代码 与 squares.py 中 @ 处 和 @ 处 的 代码 等 效 。 在 循环 中 ， 计 算 每 个 值 的 平方 ， 并 立即 
将 结果 附加 到 列表 squares 的 末尾 。 

创建 更 复杂 的 列表 时 ,可 使 用 上 述 两 种 方法 中 的 任何 一 种 。 有 了 时候, 使 用 临时 变量 会 让 代码 
更 易 读 ; 而 在 其 他 情况 下 ， 这 样 做 只 会 让 代码 无 谓 地 变 长 。 你 首先 应 该 考虑 的 是 ,编写 清晰 易 懂 
且 能 完成 所 需 功能 的 代码 ， 等 到 审核 代码 时 ， 再 考虑 采用 更 高 效 的 方法 。 


4.3.3 ”对 数字 列表 执行 简单 的 统计 计算 


有 几 个 专门 用 于 处 理 数 字 列 表 的 Python 函数 。 例 如 ， 你 可 以 轻松 地 找 出 数字 列表 的 最 大 值 、 
最 小 值 和 总 和 : 


>>> digits = [1, 2, 3, 4, 5, 6, 7, 8, 9, 0] 
>>> min(digits) 
0 


>>> max(digits) 


9 
>>> sum(digits) 
45 


注意 考虑 到 版 面 ， 本 节 使 用 的 数字 列表 都 很 短 ， 但 这 里 介绍 的 知识 也 适用 于 包含 数 百 万 个 数 
的 列表 。 
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4.3.4 列表 解析 

前 面 介绍 的 生成 列表 squares 的 方式 包含 三 四 行 代码 ,而 列表 解析 让 你 只 需 编写 一 行 代码 就 
能 生成 这 样 的 列表 。 列 表 解 析 将 for 循环 和 创建 新 元 素 的 代码 合并 成 一 行 ， 并 自动 附加 新 元 素 。 
面向 初学 者 的 书 并 非 都 会 介绍 列表 解析 , 这 里 之 所 以 介绍 列表 解析 , 是 因为 等 你 开始 阅读 他 人 编 
写 的 代码 时 ， 很 可 能 会 遇 到 它 。 

下 面 的 示例 使 用 列表 解析 创建 你 在 前 面 看 到 的 平方 数列 表 : 


squares.py squares = [value**2 for value in range(1, 11)] 
print(squares) 


要 使 用 这 种 语法 ， 首 先 指定 一 个 描述 性 的 列表 名 ， 如 squares。 然 后 ， 指 定 一 个 左 方 括号 ， 
并 定义 一 个 表达 式 ， 用 于 生成 要 存储 到 列表 中 的 值 。 在 这 个 示例 中 ,表达 式 为 value**2， 它 计算 
平方 值 。 接 下 来 ,编写 一 个 for 循环 ， 用 于 给 表达 式 提供 值 ， 再 加 上 右 方 括号 。 在 这 个 示例 中 ， 
for 循环 为 for value in range(1,11)， 它 将 值 1 ~ 10 提供 给 表达 式 value**2。 请 注意 ， 这 里 的 
for 语句 末尾 没有 冒号 。 

结果 与 前 面 的 平方 数列 表 相 同 : 


[1，4，9，16，25，36，49，64，81，100] 


要 创建 自己 的 列表 解析 ， 需 要 经 过 一 定 的 练习 ， 但 能 够 熟练 地 创建 常规 列表 后 ， 你 会 发 现 


这 样 做 是 完全 值得 的 。 当 你 觉得 编写 三 四 行 代 码 来 生成 列表 有 点 繁复 时 ， 就 应 考虑 创建 列表 解 
析 了 。 


动手 试 一 试 
练习 4-3: 数 到 20 使 用 一 个 for 循环 打印 数 1~20 ( 含 )。 
练习 4-4: 一 百 万 ”创建 一 个 包含 数 1 ~1 000 000 的 列表 ， 再 使 用 一 个 for 循环 将 
这 些 数 打印 出 来 。( 如 果 输 出 的 时 间 太 长 ， 按 CtrL+ C 停止 输出 或 关闭 输出 窗口 。) 
练习 4-$: 一 百 万 求 和 ”创建 一 个 包含 数 1~1 000 000 的 列表 ， 再 使 用 min() 和 max() 


核实 该 列表 确实 是 从 1 开始 、 到 1 000 000 结束 的 。 另 外 ， 对 这 个 列表 调用 函数 sum()， 
看 看 Python 将 一 百 万 个 数 相 加 需要 多 长 时 间 。 

练习 4-6: 奇数 通过 给 函数 Tange() 指 定 第 三 个 参数 来 创建 一 个 列表 ， 其 中 包含 
1~20 的 奇数 ， 再 使 用 一 个 for 循环 将 这 些 数 打印 出 来 。 


练习 4-7: 3 的 倍数 ”创建 一 个 列表 ,其 中 包含 3~30 能 被 3 整除 的 数 ， 再 使 用 一 
个 for 循环 将 这 个 列表 中 的 数 打印 出 来 。 
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练习 4-8: 立方 ”将 同一 个 数 乘 三 次 称 为 立方 。 例如， 在 Python 中 ，2 的 立方 用 
2**3 表示 。 请 创建 一 个 列表 ， 其 中 包含 前 10 个 整数 (1~10 ) 的 立方 ， 再 使 用 一 个 for 
循环 将 这 些 立 方 数 打印 出 来 。 


练习 4-9: 立方 解析 使 用 列表 解析 生成 一 个 列表 ， 其 中 包含 前 10 个 整数 的 立方 。 


4.4 使 用 列表 的 一 部 分 


在 第 3 章 中 ,你 学 习 了 如 何 访问 单个 列表 元 素 。 在 本 章 中 , 你 一 直 在 学 习 如 何 处 理 列 表 的 所 
有 元 素 。 你 还 可 以 处 理 列表 的 部 分 元 素 ，Python 称 之 为 切片 。 
4.4.1 切片 


要 创建 切片 ， 可 指定 要 使 用 的 第 一 个 元 素 和 最 后 一 个 元 素 的 索引 。 与 函数 range() 一 样 ， 
Python 在 到 达 第 二 个 索引 之 前 的 元 素 后 停止 。 要 输出 列表 中 的 前 三 个 元 素 , 需要 指定 索引 0 和 3， 
这 将 返回 索引 为 0、1 和 2 的 元 素 。 


下 面 的 示例 处 理 的 是 一 个 运动 队 成 员 列表 : 


players.py players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
@ print(players[0:3]) 


@ 处 的 代码 打印 该 列表 的 一 个 切片 ， 其 中 只 包含 三 名 队员 。 输出 也 是 一 个 列表 ， 其 中 包含 前 
三 名 队员 : 


'charles', 'martina', 'michael'] 


你 可 以 生成 列表 的 任意 子 集 。 例如， 如 果 要 提取 列表 的 第 二 、 第 三 和 第 四 个 元 素 , 可 将 起 始 
索引 指定 为 1， 并 将 终止 索引 指定 为 4: 


layers = ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[1:4]) 


此 时 ， 切 片 始 于 'martina' 、 终 于 'florence'。 


['martina', 'michael', 'florence'] 


如 果 没 有 指定 第 一 个 索引 ，Python 将 自动 从 列表 开头 开始 : 


players = ['charles', 'martina', "michael' ， 'florence', "eli ] 
print(players[ :4]) 
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由 于 没有 指定 起 始 索引 ，Python 从 列表 开头 开始 提取 : 


['charles', 'martina', 'michael', 'florence'] 


要 让 切片 终止 于 列表 末尾 , 也 可 使 用 类 似 的 语法 。 例如， 如 果 要 提取 从 第 三 个 元 素 到 列表 末 
尾 的 所 有 元 素 ， 可 将 起 始 索 引 指 定 为 2， 并 省 略 终止 索引 : 


players = ['charles', 'martina', 'michael', 'florence', 'eli'| 
print(players[2:]) 


Python 将 返回 从 第 三 个 元 素 到 列表 末尾 的 所 有 元 素 : 


['michael', 'florence', 'eli'] 


无 论 列 表 多 长 ， 这 种 语法 都 能 够 让 你 输出 从 特定 位 置 到 列表 末尾 的 所 有 元 素 。 上 一 章 说 过 ， 
负数 索引 返回 离 列表 末尾 相应 距离 的 元 素 ， 因 此 你 可 以 输出 列表 末尾 的 任意 切片 。 例 如 ,如 果 要 
输出 名 单 上 的 最 后 三 名 队员 ， 可 使 用 切片 players[-3:]: 


players = ['charles', 'martina'’, 'michael', 'florence', 'eli'] 
print(players[-3:]) 


上 述 代码 打印 最 后 三 名 队员 的 名 字 ， 即 便 队 员 名 单 长 度 发 生变 化 ， 也 依然 如 此 。 


注意 可 在 表示 切片 的 方 插 号 内 指定 第 三 个 值 。 这 个 值 告诉 Python 在 指定 范围 内 每 隔 多 少 元 素 
提取 一 个 。 


4.4.2 遍历 切片 


如 果 要 遍历 列表 的 部 分 元 素 ,可 在 for 循环 中 使 用 切片 。 下 面 的 示例 遍历 前 三 名 队员 ,并 打 
印 他 们 的 名 字 : 


players = [ "charles'，"martina'， 'michael', 'florence', 'eli'] 


print("Here are the first three players on my team:") 
@ for player in players[:3]: 
print(player.title()) 


@ 处 的 代码 没有 遍历 整个 队员 列表 ， 而 只 遍历 前 三 名 队员 : 


Here are the first three players on my team: 
Charles 
Martina 
Michael 


邮 
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在 很 多 情况 下 , 切片 都 很 有 用 。 例 如 ,编写 游戏 时 , 你 可 以 在 玩家 退出 游戏 时 将 其 最 终 得 分 
加 入 一 个 列表 中 , 然后 将 该 列表 按 降序 排列 以 获取 三 个 最 高 得 分 , 再 创建 一 个 只 包含 前 三 个 得 分 
的 切片 ;处 理 数据 时 ， 可 使 用 切片 来 进行 批量 处 理 ; 编写 Web 应 用 程序 时 ， 可 使 用 切片 来 分 页 
显示 信息 ， 并 在 每 页 显示 数量 合适 的 信息 。 


4.4.3 复制 列表 


我 们 经 常 需要 根据 既 有 列表 创建 全 新 的 列表 。 下 面 来 介绍 复制 列表 的 工作 原理 , 以 及 复制 列 
表 可 提供 极 大 帮助 的 一 种 情形 。 

要 复制 列表 , 可 创建 一 个 包含 整个 列表 的 切片 , 方法 是 同时 省 略 起 始 索 引 和 终止 索引 ([:] )。 
这 让 Python 创建 一 个 始 于 第 一 个 元 素 、 终 止 于 最 后 一 个 元 素 的 切片 ， 即 整个 列表 的 副本 。 

例如 ， 假 疫 有 一 个 列表 包含 你 最 喜欢 的 四 种 食品 ， 而 你 想 再 创建 一 个 列表 ， 并 在 其 中 包含 一 位 
朋友 喜欢 的 所 有 食品 。 不 过 , 你 喜欢 的 食品 , 这 位 朋友 也 都 喜欢 ,因此 可 通过 复制 来 创建 这 个 列表 : 


foods.py @myfoods = ['pizza', 'falafel', 'carrot cake'] 


@ friend foods = my foods[:] 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print(friend foods) 


首先 ， 创建 一 个 你 喜欢 的 食品 列表 ， 名 为 my_foods( 见 @ )。 然 后 创建 一 个 名 为 friend_ foods 
的 新 列表 ( 见 @ )。 在 不 指定 任何 索引 的 情况 下 从 列表 my_foods 中 提取 一 个 切片 ， 从 而 创建 这 个 列 
表 的 副本 ， 并 将 该 副本 赋 给 变量 friend foods。 打 印 这 两 个 列表 后 ， 我 们 发 现 其 包含 的 食品 相同 : 


My favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


My friend's favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


为 核实 确实 有 两 个 列表 , 下面 在 每 个 列表 中 都 添加 一 种 食品 , 并 核实 每 个 列表 都 记录 了 相应 
人 员 喜 欢 的 食品 : 


my foods = ['pizza', 'falafel', 'carrot cake'] 
@ friend foods = my foods[:] 


@ my foods.append('cannoli') 
@ friend foods.append('ice cream') 


print("My favorite foods are:") 
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print(my_foods) 


print("\nMy friend's favorite foods are:") 
print (friend foods) 


与 前 一 个 示例 一 样 , 首先 将 my_foods 的 元 素 复 制 到 新 列表 friend foods 中 ( 见 @ )。 接 下 来 ， 
在 每 个 列表 中 都 添加 一 种 食品 : 在 列表 my_foods 中 添加 'cannoli' ( 见 @ )， 而 在 friend_foods 
中 添加 'ice cream' ( 见 @ )。 最 后 ， 打 印 这 两 个 列表 ， 核 实 这 两 种 食品 分 别 包含 在 正确 的 列表 中 。 


My favorite foods are: 
@ ['pizza', 'falafel', 'carrot cake', "cannoli 


My friend's favorite foods are: 
© ['pizza', 'falafel', 'carrot cake', 'ice cream'] 


@ 处 的 输出 表明 ，'cannoli' 包 含 在 你 喜欢 的 食品 列表 中 ， 而 'ice cream' 不 在 。@ 处 的 输出 
表明 ，'ice cream' 包 含 在 你 朋友 喜欢 的 食品 列表 中 ， 而 'cannoli' 不 在 。 如 果 只 是 将 my_foods 赋 给 
friend_foods ， 就 不 能 得 到 两 个 列表 。 例 如 ， 下 面 演示 了 在 不 使 用 切片 的 情况 下 复制 列表 的 情况 : 


my foods = ['pizza', 'falafel', 'carrot cake'| 


# 这 行 不 通 : 
@ friend foods = my foods 


my_foods.append('cannoli') 
friend foods.append('ice cream') 
print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print (friend foods) 


这 里 将 my_foods 赋 给 friend foods， 而 不 是 将 my_foods 的 副本 赋 给 friend foods ( 见 @ )。 
这 种 语法 实际 上 是 让 Python 将 新 变量 friend foods 关联 到 已 与 my foods 相关 联 的 列表 ， 因 此 这 
两 个 变量 指向 同一 个 列表 。 有 鉴于 此 ， 当 我 们 将 "cannoli "添加 到 my_foods 中 时 ， 它 也 将 出 现在 
friend foods 中 。 同 样 ， 虽 然 ' ice cream' 好 像 只 被 加 入 到 了 friend_foods 中 ,但 它 也 将 出 现在 
这 两 个 列表 中 。 


输出 表明 ， 两 个 列表 是 相同 的 ， 这 并 非 我 们 想 要 的 结 


‘i 


My favorite foods are: 
['pizza'’, 'falafel', 'carrot cake'’, 'cannoli', "ice cream' 


My friend's favorite foods are: 
['pizza', 'falafel', 'carrot cake', 'cannoli', "ice cream' 


注意 ”暂时 不 要 考虑 这 个 示例 中 的 细节 。 当 试图 使 用 列表 的 副本 时 结果 出 乎 意料 ， 基 本 上 都 要 
确认 你 是 否 像 第 一 个 示例 那样 使 用 切片 复制 了 列表 。 


动手 试 一 试 
练习 4-10: 切片 ”选择 你 在 本 章 编写 的 一 个 程序 ， 在 末尾 添加 几 行 代码 ， 以 完成 如 

下 任务 。 

口 打印 消息 “The first three items in the list are:”， 再 使 用 场 片 来 打印 列表 的 前 三 个 

元 诊 : 

口 打印 消息 “Three items from the middle ofthe list are:”， 再 使 用 切片 来 打印 列表 的 

下 间 琶 人 外 元 守 5 

口 打印 消息 “The last three items in the list are:”， 再 使 用 切片 来 打印 列表 的 末尾 三 
个 

练习 4-11: 你 的 比萨 ， 我 的 比萨 在 你 为 完成 练习 4-1 而 编写 的 程序 中 ,创建 比萨 
列表 的 副本 ， 并 将 其 赋 给 变量 friend pizzas， 再 完成 如 下 任务 。 

口 在 原来 的 比萨 列表 中 添加 一 种 比萨 。 

口 在 列表 friend pizzas 中 添加 另 一 种 比萨 。 

口 核实 有 两 个 不 同 的 列表 。 为 此 ， 打 印 消 息 “My favorite pizzas are:”， 再 使 用 一 个 
for 循环 来 打印 第 一 个 列表 ; 打印 消息 “My friend’s favorite pizzas are:”， 再 使 用 
一 个 for 循环 来 打印 第 三 个 列表 。 核 实 新 增 的 比萨 被 添加 到 了 正确 的 列表 中 。 

练习 4-12: 使 用 多 个 循环 在 本 节 中 ， 为 节省 篇 幅 ， 程 序 foods.py 的 每 个 版 本 都 没 

有 使 用 for 循环 来 打印 列表 。 请 选择 一 个 版 本 的 foods.py， 在 其 中 编写 两 个 for 循环 ， 

将 各 个 食品 列表 打印 出 来 。 


4.5 ”元 组 


列表 非常 适合 用 于 存储 在 程序 运行 期 间 可 能 变化 的 数据 集 。 列表 是 可 以 修改 的 , 这 对 处 理 网 
站 的 用 户 列表 或 游戏 中 的 角色 列表 至 关 重 要 。 然 而 ， 有 时 候 你 需要 创建 一 系列 不 可 修改 的 元 素 ， 
元 组 可 以 满足 这 种 需求 。Python 将 不 能 修改 的 值 称 为 不 可 变 的 ， 而 不 可 变 的 列表 被 称 为 元 组 。 


4.5.1 定义 元 组 


元 组 看 起 来 很 像 列表 , 但 使 用 圆 括 号 而 非 中 括号 来 标识 。 定 义 元 组 后 ， 就 可 使 用 索引 来 访问 
其 元 素 ， 就 像 访 问 列表 元 素 一 样 


O 
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例如 ,如 果 有 一 个 大 小 不 应 改变 的 矩 形 , 可 将 其 长 度 和 宽度 存储 在 一 个 元 组 中 ， 从 而 确保 它 
们 是 不 能 修改 的 : 


dimensions.py @ dimensions = (200, 50) 
@ print(dimensions[0]) 
print(dimensions[1]) 


首先 定义 元 组 dimensions( 见 @ )， 为 此 使 用 了 圆 括号 而 不 是 方 括号 。 接 下 来 ， 分 别 打印 该 
元 组 的 各 个 元 素 ， 使 用 的 语法 与 访问 列表 元 素 时 使 用 的 语法 相同 〈 见 @ ): 


200 
50 


下 面 来 尝试 修改 元 组 dimensions 的 一 个 元 素 ， 看 看 结果 如 何 : 


dimensions = (200，50) 
@ dimensions[0] = 250 


@ 处 的 代码 试图 修改 第 一 个 元 素 的 值 ， 导 致 Python 返回 类 型 错误 消息 。 由 于 试图 修改 元 组 
的 操作 是 被 禁止 的 ， 因 此 Python 指出 不 能 给 元 组 的 元 素 赋 值 : 


Traceback (most recent call last): 
File "dimensions.py", line 2, in <module> 
dimensions[0] = 250 
TypeError: 'tuple' object does not support item assignment 


这 很 好 ， 因 为 我 们 希望 Python 在 代码 试图 修改 矩形 的 尺寸 时 引发 错误 。 


注意 ”严格 地 说 ， 元 组 是 由 过 号 标识 的 ， 圆 括号 只 是 让 元 组 看 起 来 更 整洁 


、 更 清晰 。 如 果 你 要 
定义 只 包含 一 个 元 素 的 元 组 ， 必 须 在 这 个 元 素 后 面 加 上 过 号 : 


人 
储 
;5 
(ey 
| 
广 


元 素 的 元 组 通常 没有 意义 ， 但 自动 生成 的 元 组 有 可 能 只 有 一 个 元 素 。 


4.5.2 遍历 元 组 中 的 所 有 值 
像 列表 一 样 ， 也 可 以 使 用 for 循环 来 遍历 元 组 中 的 所 有 值 : 


dimensions = (200，50) 
for dimension in dimensions : 
print(dimension) 


就 像 遍 历 列 表 时 一 样 ，Python 返回 元 组 中 所 有 的 元 素 : 


200 
50 


4.5.3 修改 元 组 变量 


虽然 不 能 修改 元 组 的 元 素 , 但 可 以 给 存储 元 组 的 变量 赋值 。 因 此 ， 如 果 要 修改 前 述 矩 形 的 尺 Eo 
寸 ， 可 重新 定义 整个 元 组 : 


@ dimensions = (200，50) 
print("Original dimensions:") 
for dimension in dimensions: 
print(dimension) 


@ dimensions = (400, 100) 

四 print("\nModified dimensions:") 
for dimension in dimensions: 
print(dimension) 


首先 定义 一 个 元 组 ， 并 将 其 存储 的 尺寸 打印 出 来 ( 见 @ )。 接 下 来 ， 将 一 个 新 元 组 关联 到 变 
量 dimensions ( 见 @ )。 然 后， 打印 新 的 尺寸 ( 见 @ )。 这 次 ，Python 不 会 引发 任何 错误 ， 因 为 给 
元 组 变量 重新 赋值 是 合法 的 : 


Original dimensions : 
200 
50 


Modified dimensions : 
400 
100 


相 比 于 列表 , 元 组 是 更 简单 的 数据 结构 。 如 果 需 要 存储 的 一 组 值 在 程序 的 整个 生命 周期 内 都 
不 变 ， 就 可 以 使 用 元 组 。 


动手 试 一 试 
练习 4-13: 自助 餐 ”有 一 家 自助 式 餐 馆 ， 只 提供 五 种 简单 的 食品 。 请 想 出 五 种 简单 
的 食品 ， 并 将 其 存储 在 一 个 元 组 中 。 


口 使 用 一 个 for 循环 将 该 餐馆 提供 的 五 种 食品 都 打印 出 来 。 

口 尝试 修改 其 中 的 一 个 元 素 ， 核 实 Python 确实 会 拒绝 你 这 样 做 。 

口 餐馆 调整 了 菜单 ， 替 换 了 它 提供 的 其 中 两 种 食品 。 请 编写 一 个 这 样 的 代码 块 : 
给 元 组 变量 赋值 ， 并 使 用 一 个 for 循环 将 新 元 组 的 每 个 元 素 都 打印 出 来 。 
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4.6 ”设置 代码 格式 


随 着 你 编写 的 程序 越 来 越 长 , 有 必要 了 解 一 些 代码 格式 设置 约定 。 请 花 时 间 让 你 的 代码 尽 可 
能 易于 阅读 。 这 有 助 于 你 掌握 程序 是 做 什么 的 ， 也 可 以 帮助 他 人 理解 你 编写 的 代码 。 

为 确保 所 有 人 编写 的 代码 结构 都 大 致 一 致 , Python 程序 员 会 遵循 一 些 格式 设置 约定 。 学 会 纺 
写 整洁 的 Python 后 ， 就 能 明白 他 人 编写 的 Python 代码 的 整体 结构 一 一 只 要 他 们 和 你 遵循 相同 的 
指南 。 要 成 为 专业 程序 员 ， 应 从 现在 开始 就 遵循 这 些 指 南 ， 以 养 成 良好 的 习惯 。 


4.6.1 格式 设置 指南 


要 提出 Python 语言 修改 建议 ， 需 要 编写 Python 改进 提案 ( Python Enhancement Proposal，PEP )。 
PEP 8 是 最 古老 的 PEP 之 一 , 向 Python 程序 员 提 供 了 代码 格式 设置 指南 。PEP 8 的 篇 幅 很 长 , 但 
基本 上 与 复杂 的 编码 结构 相关 。 

Python 格式 设置 指南 的 编写 者 深 知 ， 代 码 被 阅读 的 次 数 比 编写 的 次 数 多 。 代 码 编写 出 来 后 ， 
调试 时 需要 阅读 ; 给 程序 添加 新 功能 时 ， 需 要 花 很 长 的 时 间 阅 读 ; 与 其 他 程序 员 分 享 代码 时 ， 这 
些 程序 员 也 会 阅读 。 

如 果 一 定 要 在 让 代码 易于 编写 和 易于 阅读 之 间 做 出 选择 ，Python 程序 员 几 乎 总 是 选择 后 者 。 
下 面 的 指南 可 帮助 你 从 一 开始 就 编写 出 清晰 的 代码 。 


4.6.2 ” 缩 进 

PEP 8 建议 每 级 缩 进 都 使 用 四 个 空格 。 这 既 可 提高 可 读 性 ， 又 留 下 了 足够 的 多 级 缩 进 空间 。 

在 字 处 理 文档 中 , 大 家 常常 使 用 制 表 符 而 不 是 空格 来 缩 进 。 对 于 字 处 理 文档 来 说 ， 这样 做 的 
效果 很 好 ， 但 混合 使 用 制 表 符 和 空格 会 让 Python 解释 器 感到 迷惑 。 每 款 文 本 编辑 器 都 提供 了 一 
种 设置 ， 可 将 你 输入 的 制 表 符 转换 为 指定 数量 的 空格 。 你 在 编写 代码 时 绝对 应 该 使 用 制 表 符 键 ， 
但 一 定 要 对 编辑 器 进行 设置 ， 使 其 在 文档 中 插入 空格 而 不 是 制 表 符 。 

在 程序 中 混合 使 用 制 表 符 和 空格 可 能 导致 极 难 排查 的 问题 。 如 果 混 合 使 用 了 制 表 符 和 空格 ， 
可 将 文件 中 的 所 有 制 表 符 都 转换 为 空格 ， 大 多 数 编辑 带 提 供 了 这 样 的 功能 。 


4.6.3 行 长 


很 多 Python 程序 员 建 议 每 行 不 超过 80 字符 。 最 初 制定 这 样 的 指南 时 ， 在 大 多 数 计算 机 中 ， 
终端 窗口 每 行 只 能 容纳 79 字符 。 当 前 ， 计 算 机 屏幕 每 行 可 容纳 的 字符 数 多 得 多 ， 为 何 还 要 使 用 
79 字符 的 标准 行 长 呢 ? 这 里 有 别 的 原因 。 专 业 程 序 员 通常 会 在 同一 个 屏幕 上 打开 多 个 文件 ， 使 
用 标准 行 长 可 以 让 他 们 在 屏幕 上 并 排 打开 两 三 个 文件 时 同时 看 到 各 个 文件 的 完整 行 。PEP 8 还 建 
议 注释 的 行 长 不 应 超过 72 字符 ， 因 为 有 些 工具 为 大 型 项 目 自动 生成 文档 时 ， 会 在 每 行 注释 开头 
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添加 格式 化 字符 。 

PEP 8 中 有 关 行 长 的 指南 并 非 不 可 逾越 的 红线 ， 有 些小 组 将 最 大 行 长 设置 为 99 字符。 在 学 习 期 
间 ， 你 不 用 过 多 考虑 代码 的 行 长 ， 但 别 忘 了 ， 协 作 编 写 程序 时 ， 大 家 几乎 都 遵守 PEP 8 指南 。 在 大 
多 数 编辑 器 中 ， 可 以 设置 一 个 视觉 标志 (通常 是 一 条 坚 线 )， 让 你 知道 不 能 越过 的 界线 在 什么 地 方 。 


注意 ”附录 B 介绍 了 如 何 配 置 文 本 编辑 器 ， 使 其 在 你 按 制 表 符 键 时 插入 四 个 空格 ， 并 且 显 示 一 
条 垂直 参考 线 ， 帮 助 你 遵守 行 长 不 超过 79 字符 的 约定 。 


4.6.4” 空 行 


要 将 程序 的 不 同 部 分 分 开 ， 可 使 用 空 行 。 你 应 该 使 用 空 行 来 组 织 程序 文件 ， 但 也 不 能 滥用 。 
只 要 按 本 书 的 示例 展示 的 那样 做 ， 就 能 掌握 其 中 的 平衡 。 例 如 ， 如 果 你 有 五 行 创建 列表 的 代码 ， 
还 有 三 行 处 理 该 列表 的 代码 ,那么 用 一 个 空 行将 这 两 部 分 隔 开 是 合适 的 。 然 而 ,你 不 应 使 用 三 四 
个 空 行将 其 隔 开 。 


空 行 不 会 影响 代码 的 运行 , 但 会 影响 代码 的 可 读 性 。 Python 解释 器 根据 水 平 缩 进 情况 来 解读 
代码 ， 但 不 关心 垂直 间距 。 


4.6.5 ”其 他 格式 设置 指南 


PEP 8 还 有 很 多 其 他 的 格式 设置 建议 ， 但 这 些 指南 针对 的 程序 大 多 比 目 前 为 止 本 书 提 到 的 程 
序 复杂 。 等 介绍 更 复杂 的 Python 结构 时 ， 我 们 再 来 分 享 相关 的 PEP 8 指南 。 


动手 试 一 斌 
练习 4-14: PEP 8 请 访问 Python 网 站 并 搜索 “PEP 8 一 Style Guide for Python 
Code”， 阅 读 PEP 8 格式 设置 指南 。 当 前 ， 这 些 指南 适用 的 情况 不 多 ， 但 可 以 大 致 浏览 
= 
练习 4-15: 代码 审核 ”从 本 章 编 写 的 程序 中 选择 三 个 ,根据 PEP 8 指南 对 它们 进行 
修改 。 


口 每 级 缩 进 都 使 用 四 个 空格 。 对 你 使 用 的 文本 编辑 器 进行 设置 ， 使 其 在 你 按 Tab 
键 时 插入 四 个 空格 。 如 果 你 还 没有 这 样 做 ， 现 在 就 去 做 吧 (有 关 如 何 设置 ， 请 
参阅 附录 B )。 

口 每 行 都 不 要 超过 80 字符 。 对 你 使 用 的 编辑 器 进行 设置 ， 使 其 在 第 80 个 字符 处 

显示 一 条 垂直 参考 线 。 

口 不 要 在 程序 文件 中 过 多 使 用 空 行 。 


62 第 4 章 操作 列表 


4.7 小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 高 效 地 处 理 列表 中 的 元 素 ; 如 何 使 用 for 循环 遍历 列表 ，Python 
如 何 根据 缩 进 来 确定 程序 的 结构 , 以 及 如 何 避 免 一 些 常见 的 缩 进 错误 ; 如 何 创建 简单 的 数字 列表 ， 
以 及 可 对 数字 列表 执行 的 一 些 操作 ; 如 何 通过 切片 来 使 用 列表 的 一 部 分 和 复制 列表 。 你 还 学 习 了 
元 组 ( 它 对 不 应 变化 的 值 提供 了 一 定 程度 的 保护 ) 以 及 在 代码 变 得 越 来 越 复杂 时 如 何 设置 格式 ， 
使 其 易于 阅读 。 

在 第 5 章 中 ， 你 将 学 习 如 何 使 用 if 语句 在 不 同 的 条 件 下 采取 不 同 的 措施 ; 如 何 将 一 组 较 复 
杂 的 条 件 测试 组 合 起 来 ， 并 在 满足 特定 条 件 时 采取 相应 的 措施 。 你 还 将 学 习 如 何在 遍历 列表 时 ， 
通过 使 用 if 语句 对 特定 元 素 采取 特定 的 措施 。 


第 5 章 


if 语句 


编程 时 经 常 需要 检查 一 系列 条 件 ， 并 据 此 决定 采取 什么 措施 。 
在 Python 中 ， if 语句 让 你 能 够 检查 程序 的 当前 状态 ， 并 采取 相应 的 
萌 施 。 

在 本 章 中 ， 你 将 学 习 条 件 测试 ， 以 检查 所 关心 的 任何 条 件 。 你 将 
学 习 简 单 的 if 语句 ,以 及 创建 一 系列 复杂 的 if 语句 来 确定 当前 到 底 
处 于 什么 情形 。 接 下 来 ， 你 将 把 学 到 的 知识 应 用 于 列表 ， 编 写 一 个 
for 循环 ， 以 一 种 方式 处 理 列表 中 的 大 多 数 元 素 ， 并 以 另 一 种 方式 处 
理 包 含 特定 值 的 元 素 。 


5.1 一 个 简单 示例 


下 面 是 一 个 简短 的 示例 ， 演 示 了 如 何 使 用 if 语句 来 正确 地 处 理 特殊 情形 。 假 设 你 有 一 个 汽 
车 列表 ,并 想 将 其 中 每 辆 汽车 的 名 称 打印 出 来 。 对 于 大 多 数 汽车 , 应 以 首 字母 大 写 的 方式 打印 其 
名 称 ,但 对 于 汽车 名 'bmw' ， 应 以 全 大 写 的 方式 打印 。 下 面 的 代码 遍历 这 个 列表 ， 并 以 首 字母 大 
写 的 方式 打印 其 中 的 汽车 名 ， 不 过 对 于 'bmw'  ， 则 以 全 大 写 的 方式 打印 : 


cars.py Cars = ['audi', 'bmw', 'subaru', 'toyota'] 


for car in cars: 
© if car == “bmw' : 
print(car.upper()) 
else: 
print(car.title()) 


这 个 示例 中 的 循环 首先 检查 当前 的 汽车 名 是 否 是 'bmw”( 见 @ )。 如 果 是 ， 就 以 全 大 写 方 式 打 
印 ， 否 则 以 首 字母 大 写 的 方式 打印 : 
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Audi 
BMW 
Subaru 
Toyota 


这 个 示例 涵盖 了 本 章 将 介绍 的 很 多 概念 。 下 面 先 来 介绍 可 用 来 在 程序 中 检查 条 件 的 测试 。 


5.2 ”条件 测试 


每 条 if 语句 的 核心 都 是 一 个 值 为 True 或 False 的 表达 式 , 这 种 表达 式 称 为 条 件 测试 ,Python 
根据 条 件 测试 的 值 为 True 还 是 False 来 决定 是 否 执 行 if 语句 中 的 代码 。 如 果 条 件 测试 的 值 为 
True，Python 就 执行 紧 跟 在 if 语句 后 面 的 代码 ; 如 果 为 False，Python 就 忽略 这 些 代 码 。 


5.2.1 检查 是 否 相 等 


大 多 数 条件 测 试 将 一 个 变量 的 当前 值 同 特定 值 进行 比较 。 最 简单 的 条 件 测试 检查 变量 的 值 是 
否 与 特定 值 相 等 : 


@ >>> car = 'bmw' 
@ >>> car == “bmw' 
True 


首先 使 用 一 个 等 号 将 car 的 值 设置 为 'bmw' ( 见 @ )， 这 种 做 法 你 已 经 见 过 很 多 次 。 接 下 来 ， 
使 用 两 个 等 号 ( == ) 检查 car 的 值 是 否 为 'bmw' ( 见 @ )。 这 个 相等 运算 符 在 两 边 的 值 相等 时 返回 
True， 否 则 返回 False。 在 本 例 中 ， 两 边 的 值 相等 ， 因 此 Python 返回 True。 


如 果 变 量 car 的 值 不 是 'bmw' ， 上 述 测试 将 返回 False: 


@ >>> car = 'audi' 
@ >>> car == “bmw' 
False 


一 个 等 号 是 陈述 ， 于 是 @ 处 的 代码 可 解读 为 : 将 变量 car 的 值 设置 为 'audi'。 两 个 等 号 则 是 
发 问 ， 于 是 @@ 处 的 代码 可 解读 为 : 变量 car 的 值 是 'bmw' 吗 ”大 多 数 编程 语言 使 用 等 号 的 方式 与 
这 里 演示 的 相同 。 

5.2.2 检查 是 否 相 等 时 忽略 大 小 写 
在 Python 中 检查 是 否 相 等 时 区 分 大 小 写 。 例 如 ， 两 个 大 小 写 不 同 的 值 被 视 为 不 相等 : 


>>> car = 'Audi' 
>>> car == "audi' 
False 
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如 果 大 小 写 很 重要 ， 这 种 行为 有 其 优点 。 但 如 果 大 小 写 无 关 紧要 ， 只 想 检 查 变 量 的 值 ， 可 将 
变量 的 值 转换 为 小 写 ， 再 进行 比较 : 


>>> car = "Audi 
>>> car.lower() == 'audi' 
True 


无 论 值 'Audi' 的 大 小 写 如 何 , 上 述 测 试 都 将 返回 True, 因为 该 测试 不 区 分 大 小 写 。 函 数 lower() 


不 会 修改 最 初 赋 给 变量 car 的 值 ， 因 此 进行 这 样 的 比较 时 不 会 影响 原来 的 变量 : 国 国 
©@ >>> car = 'Audi' 
@ >>> car.lower() == 'audi’ 
True 
©@ >>> car 
"Audi 


在 @ 处 ， 将 首 字母 大 写 的 字符 串 'Audi ' 赋 给 变量 car。 在 @ 处 ， 获 取 变 量 car 的 值 并 将 其 转 
换 为 小 写 ， 再 将 结果 与 字符 串 'audi' 进 行 比 较 。 这 两 个 字符 串 相 同 ， 因 此 Python 返回 True。 从 
@ 处 的 输出 可 知 ， 方 法 lower() 并 没有 影响 关联 到 变量 car 的 值 。 


网 站 采用 类 似 的 方式 让 用 户 输入 的 数据 符合 特定 的 格式 。 例 如 , 网 站 可 能 使 用 类 似 的 测试 来 
确保 用 户 名 是 独一无二 的 ， 而 并 非 只 是 与 男 一 个 用 户 名 的 大 小 写 不 同 。 用 户 提交 新 的 用 户 名 时 ， 
将 把 它 转换 为 小 写 , 并 与 所 有 既 有 用 户 名 的 小 写 版 本 进行 比较 。 执 行 这 种 检查 时 ， 如果 已 经 有 用 
户 名 'john" (不 管 大 小 写 如 何 )， 则 用 户 提交 用 户 名 'John 时 将 遭 到 拒绝 。 


5.2.3 ”检查 是 否 不 相等 
要 判断 两 个 值 是 否 不 等 ， 可 结合 使 用 惊叹 号 和 等 号 ( != )， 其 中 的 惊叹 号 表示 不 ， 其 他 很 多 
编程 语言 中 也 是 如 此 。 
下 面 再 使 用 一 条 if 语句 来 演示 如 何 使 用 不 等 运算 符 。 我 们 将 把 要 求 的 比萨 配料 赋 给 一 个 变 
量 ， 再 打印 一 条 消息 ， 指 出 顾客 要 求 的 配料 是 否 是 意 式 小 银 鱼 ( anchovies ): 


toppings.py requested topping = “mushrooms 


@ if requested topping != 'anchovies': 
print("Hold the anchovies!") 


@ 处 的 代码 行将 requested_topping 的 值 与 'anchovies' 进 行 比较 。 如 果 这 两 个 值 不 相等 ， 
Python 将 返回 True， 进 而 执行 紧 跟 在 if 语句 后 面 的 代码 ; 如 果 相 等 ，Python 将 返回 False， 
此 不 执行 紧 跟 在 if 语句 后 面 的 代码 。 


因为 requested topping 的 值 不 是 'anchovies' ， 所 以 执行 函数 调用 print(): 
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Hold the anchovies! 


你 编写 的 大 多 数 条 件 表达 式 检 查 两 个 值 是 否 相 等 , 但 有 时 候 检 查 两 个 值 是 否 不 等 的 效率 更 


[= 


IBJ o 


5.2.4 数值 比较 
检查 数值 非常 简单 。 例 如 ， 下 面 的 代码 检查 一 个 人 是 否 是 18 岁 : 


>>> age = 18 
>>> age == 18 
True 


还 可 检查 两 个 数 是 否 不 等 。 例 如 ， 下 面 的 代码 在 提供 的 答案 不 正确 时 打印 一 条 消息 : 


magic answeT = 17 
numberpy 


@ if answer != 42: 


print("That is not the correct answer. Please try again!") 


answer 的 值 (17 ) 不 是 42，@ 处 的 条 件 得 到 满足 ， 因 此 缩 进 的 代码 块 得 以 执行 : 


That is not the correct answer. Please try again! 


条 件 语句 中 可 包含 各 种 数学 比较 ， 如 小 于 、 小 于 等 于 、 大 于 、 大 于 等 于 : 


>>> age = 19 
>>> age < 21 

True 

>>> age <= 21 
True 

>>> age > 21 

False 

>>> age >= 21 
False 


在 if 语句 中 可 使 用 各 种 数学 比较 ， 这 让 你 能 够 直接 检查 关心 的 条 件 。 
5.2.5 ”检查 多 个 条 件 


你 可 能 想 同时 检查 多 个 条 件 。 例 如 ， 有 时 候 需 要 在 两 个 条 件 都 为 True 时 才 执 行 相 应 的 操作 ， 
而 有 时 候 只 要 求 一 个 条 件 为 True。 在 这 些 情 况 下 ， 关 键 字 and 和 or 可 助 你 一 辟 之 力 。 


1. 使 用 and 检查 多 个 条 件 


要 检查 是 否 两 个 条 件 都 为 True, 可 使 用 关键 字 and 将 两 个 条 件 测试 合 而 为 


。 如果 每 个 测试 
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都 通过 了 ， 整 个 表达 式 就 为 True; 如 果 至 少 一 个 测试 没有 通过 ， 整 个 表达 式 就 为 False。 
例如 ， 要 检查 是 否 两 个 人 都 不 小 于 21 岁 ， 可 使 用 下 面 的 测试 : 


@ >>>age 0 = 22 
>>> age 1 = 18 

@ >>> age 0 >= 21 and age 1 >= 21 
False 

© >>> age 1 = 22 
>>> age 0 >= 21 and age 1 >= 21 
True 


在 @ 处 , 定义 两 个 用 于 存储 年 龄 的 变量 : age 0 和 age 1。 在 @ 处 , 检查 这 两 个 变量 是 否 都 大 
于 或 等 于 21。 左边 的 测试 通过 了 , 但 右边 的 测试 没有 通过 , 因此 整个 条 件 表达 式 的 结果 为 False。 
在 @ 处 , 将 age _1 改 为 22, 这 样 age 1 的 值 大 于 21， 因 此 两 个 测试 都 通过 了 ， 导致 整个 条 件 表 达 
式 的 结果 为 True。 

为 改善 可 读 性 ， 可 将 每 个 测试 分 别 放 在 一 对 圆 括号 内 , 但 并 非 必须 这 样 做 。 如 果 你 使 用 圆 括 
号 ， 测 试 将 类 似 于 下 面 这 样 : 


(age 0 >= 21) and (age 1 >= 21) 


2. 使 用 or 检查 多 个 条 件 

关键 字 or 也 能 够 让 你 检查 多 个 条 件 ， 但 只 要 至 少 一 个 条 件 满足 ， 就 能 通过 整个 测试 。 仅 当 
两 个 测试 都 没有 通过 时 ， 使 用 or 的 表达 式 才 为 False。 

下 面 再 次 检查 两 个 人 的 年 龄 ， 但 检查 的 条 件 是 至 少 一 个 人 的 年 龄 不 小 于 21 岁 : 


@ >>> age 0 = 22 
>>> age 1 = 18 

@ >>> age 0 >= 21 or age 1 >= 21 
True 

© >>> age 0=18 
>>> age 0 >= 21 or age 1 >= 21 
False 


同样 ， 首 先 定义 两 个 用 于 存储 年 龄 的 变量 ( 见 @ )。@ 处 对 age_0 的 测试 通过 了 ， 因 此 整个 表 
达 式 的 结果 为 True。 接 下 来 , 将 age_0 减 小 为 18。 在 @ 处 的 测试 中 ， 两 个 测试 都 没有 通过 ,因此 
整个 表达 式 的 结果 为 False。 


5.2.6 ”检查 特定 值 是 否 包 含 在 列表 中 


有 时 候 ,， 执行 操作 前 必须 检查 列表 是 否 包 含 特定 的 值 。 例 如 ,结束 用 户 的 注册 过 程 前 ,可 能 
需要 检查 他 提供 的 用 户 名 是 否 已 包含 在 用 户 名 列表 中 。 在 地 图 程序 中 , 可 能 需要 检查 用 户 提交 的 
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位 置 是 否 包含 在 已 知 位 置 列表 中 。 

要 判断 特定 的 值 是 否 已 包含 在 列表 中 ， 可 使 用 关键 字 in。 下 面 来 看 看 你 可 能 为 比萨 店 编写 
的 一 些 代码 。 这 些 代码 首先 创建 一 个 列表 ， 其 中 包含 用 户 点 的 比萨 配料 ， 然 后 检查 特定 的 配料 是 
否 包含 在 该 列表 中 。 


>>> requested toppings = ['mushrooms', 'onions', 'pineapple'] 
@ >>> 'mushrooms' in requested toppings 

True 
@ >>> 'pepperoni' in requested toppings 

False 


在 @ 人 处 和 @ 人 处 ， 关 键 字 in 让 Python 检查 列表 requested toppings 是 否 包 含 'mushrooms' 和 
'pepperoni'。 这 种 技术 很 有 用 ， 让 你 能 够 在 创建 一 个 列表 后 ， 轻 松 地 检查 其 中 是 否 包含 特定 的 值 。 


5.2.7 ”检查 特定 值 是 否 不 包含 在 列表 中 
还 有 些 时 候 ， 确 定 特定 的 值 未 包含 在 列表 中 很 重要 。 在 这 种 情况 下 ， 可 使 用 关键 字 not in。 
例如 ， 有 一 个 列表 ,其 中 包含 被 禁止 在 论坛 上 发 表 评论 的 用 户 , 可 以 在 允许 用 户 提交 评论 前 检查 


他 是 否 被 禁 言 : 


banned_ banned users = ['andrew', 'carolina', 'david'] 
users.py User = "marie' 


@ if user not in banned users: 
print(f"{user.title()}, you can post a response if you wish.") 


@ 处 的 代码 行 明白 易 懂 : 如 果 user 的 值 未 包含 在 列表 banned_users 中 , Python 将 返回 True， 
进而 执行 缩 进 的 代码 行 。 
用 户 'marie' 未 包含 在 列表 banned_users 中 ， 因 此 她 将 看 到 一 条 邀请 她 发 表 评 论 的 消息 : 


arie, you can post a response if you wish . 


5.2.8 布尔 表达 式 

随 着 你 对 编程 的 了 解 越 来 越 深 入 , 将 遇 到 术语 布尔 表达 式 , 它 不 过 是 条 件 测试 的 别名 。 与 条 
件 表 达 式 一 样 ， 布 尔 表达 式 的 结果 要 么 为 True， 要 人 么 为 False。 

布尔 值 通 常用 于 记录 条 件 ， 如 游戏 是 否 正 在 运行 ， 或 者 用 户 是 否 可 以 编辑 网 站 的 特定 内 容 : 


game _active = True 
can edit = False 
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在 跟踪 程序 状态 或 程序 中 重要 的 条 件 方 面 ， 布 尔 值 提供 了 一 种 高 效 的 方式 。 


动手 试 一 试 
练习 5-1: 条 件 测试 ”编写 一 系列 条 件 测试 ， 将 每 个 测试 以 及 对 其 结果 的 预测 和 实 
际 结果 打印 出 来 。 你 编写 的 代码 应 类 似 于 下 面 这 样 : 


car = Subaru' 
int( ISECarss suUpar rpredict Truee) 
int(car == 'subaru') 


int("\nls car == "audi'? I predict False.") 
Tae elven ) 


口 详细 研究 实际 结果 ， 直 到 你 明白 它 为 何 为 True 或 False。 


口 创建 至 少 10 个 测试 ， 且 其 中 结果 分 别 为 True 和 False 的 测试 都 至 少 有 5 个 。 

练习 5-2: 更 多 条 件 测试 ”你 并 非 只 能 创建 10 个 测试 。 如 果 想 尝试 做 更 多 比较 ， 可 
再 编写 一 些 测 试 ， 并 将 它们 加 入 conditional tests.py 中 。 对 于 下 面 列 出 的 各 种 情况 ， 至 
少 编写 两 个 结果 分 别 为 True 和 False 的 测试 。 


口 检查 两 个 字符 串 相 等 和 不 等 。 

口 使 用 方法 lower() 的 测试 。 

口 涉及 相等 、 不 等 、 大 于 、 小 于 、 大 于 等 于 和 小 于 等 于 的 数值 测试 。 
口 使 用 关键 字 and 和 or 的 测试 。 

口 测试 特定 的 值 是 否 包 含 在 列表 中 。 

口 测试 特定 的 值 是 否 未 包含 在 列表 中 。 


5.3 if 语句 


理解 条 件 测试 后 ， 就 可 以 开始 编写 if 语句 了 。if 语句 有 很 多 种 ， 选 择 使 用 哪 种 取决 于 要 测 
试 的 条 件数 。 前 面 讨论 条 件 测 试 时 ， 列 举 了 多 个 if 语句 示例 ， 下 面 更 深入 地 讨论 这 个 主题 。 


5.3.1 简单 的 if 语句 
最 简单 的 if 语 句 只 有 一 个 测试 和 一 个 操作 : 


if conditional test: 
do something 


第 一 行 可 包含 任何 条 件 测试 ， 而 在 紧 跟 在 测试 后 面 的 缩 进 代码 块 中 , 可 执行 任何 操作 。 如 果 
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条 件 测试 的 结果 为 True，Python 就 会 执行 紧 跟 在 if 语句 后 面 的 代码 ， 否 则 Python 将 忽略 这 些 
代码 。 


假设 有 一 个 表示 某 人 年 龄 的 变量 , 而 你 想 知道 这 个 人 是 否 符合 投票 的 年 龄 , 可 使 用 如 下 代码 : 


voting.py age = 19 
@ if age >= 18: 
@ print("You are old enough to vote!") 


在 @ 处 ，Python 检查 变量 age 的 值 是 否 大 于 或 等 于 18。 答 案 是 肯定 的 ， 因 此 Python 执行 @ 
处 缩 进 的 函数 调用 print(): 


You are old enough to votel 


在 计 语 句 中 ， 缩 进 的 作用 与 在 for 循环 中 相同 。 如 果 测 试 通过 了 ,将 执行 if 语句 后 面 所 有 
缩 进 的 代码 行 ， 否 则 将 忽略 它们 。 

在 紧 跟 if 语句 后 面 的 代码 块 中 ， 可 根据 需要 包含 任意 数量 的 代码 行 。 下 面 在 一 个 人 符合 投 
票 年 龄 时 再 打印 一 行 输出 ， 问 他 是 否 登 记 了 : 


age = 19 
if age >= 18: 
print("You are old enough to vote!") 
print("Have you registered to vote yet?") 


条 件 测试 通过 了 ， 而 且 两 个 函数 调用 print() 都 缩 进 了 ， 因 此 它们 都 将 执行 : 


You are old enough to votel 
Have you registered to vote yet? 


如 果 age 的 值 小 于 18， 这 个 程序 将 不 会 有 任何 输出 。 


5.3.2 ”if-else 语句 


我 们 经 常 需要 在 条 件 测试 通过 时 执行 一 个 操作 , 在 没有 通过 时 执行 另 一 个 操作 。 在 这 种 情况 
下 ， 可 使 用 Python 提供 的 if-else 语句 。if-else 语句 块 类 似 于 简单 的 if 语句 ， 但 其 中 的 else 
语句 让 你 能 够 指定 条 件 测试 未 通过 时 要 执行 的 操作 。 


下 面 的 代码 在 一 个 人 符合 投票 年 龄 时 显示 与 前 面相 同 的 消息 ， 在 不 符合 时 显示 一 条 新 消息 : 


age = 17 
@ if age >= 18: 
print("You are old enough to vote!") 
print("Have you registered to vote yet?") 
@ else: 
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print("Sorry, you are too young to vote.") 
print("Please register to vote as soon as you turn 18!") 


如 果 @ 处 的 条 件 测试 通过 了 , 就 执行 第 一 组 缩 进 的 函数 调用 print()。 如 果 测 试 结果 为 False， 
就 执行 @ 人 处 的 else 代码 块 。 这 次 age 小 于 18, 条 件 测试 未 通过 , 因此 执行 else 代码 块 中 的 代码 : 


Sorry, you are too young to vote. 
Please register to vote as soon as you turn 18! 


上 述 代码 之 所 以 可 行 ， 是 因为 只 存在 两 种 情形 : 要 么 符合 投票 年 龄 ， 要 人 么 不 符合 。if-else 
结构 非常 适合 用 于 让 Python 执行 两 种 操作 之 一 的 情形 。 在 这 样 简单 的 if-else 结构 中 , 总 是 会 执 
行 两 个 操作 中 的 一 个 。 


5.3.3 ”if-elif-else 结构 


我 们 经 常 需要 检查 超过 两 个 的 情形 ， 为 此 可 使 用 Python 提供 的 if-elif-else 结构 。Python 
只 执行 if-elif-else 结构 中 的 一 个 代码 块 。 它 依次 检查 每 个 条 件 测试 ， 直 到 遇 到 通过 了 的 条 件 
测试 。 测 试 通过 后 ，Python 将 执行 紧 跟 在 它 后 面 的 代码 ， 并 跳 过 余下 的 测试 。 

在 现实 世界 中 , 很 多 情况 下 需要 考虑 的 情形 超过 两 个 。 例 如 , 来 看 一 个 根据 年 龄 段 收 费 的 游 
乐 场 : 
口 4 岁 以 下 免费 ; 
口 4~18 岁 收费 25 美元 ; 
口 18 岁 ( 含 ) 以 上 收费 40 美元 。 
如 果 只 使 用 一 条 if 语句 ， 该 如 何 确定 门票 价格 呢 ? 下 面 的 代码 确定 一 个 人 所 属 的 年 龄 段 ， 
并 打印 一 条 包含 门票 价格 的 消息 : 


amusement age = 2 
park.py 

@ if age 4: 
print("Your admission cost is $0.") 
@ elif age < 18: 
print("Your admission cost is $25.") 
©@ else: 
print("Your admission cost is $40.") 


@ 处 的 if 测试 检查 一 个 人 是 否 不 满 4 岁 。 如 果 是 ，Python 就 打印 一 条 合适 的 消息 ， 并 跳 过 
余下 测试 。@ 处 的 elif 代码 行 其 实 是 另 一 个 if 测试 ， 仪 在 前 面 的 测试 未 通过 时 才 会 运行 。 在 这 
里 ,我 们 知道 这 个 人 不 小 于 4 岁 ， 因 为 第 一 个 测试 未 通过 。 如 果 这 个 人 未 满 18 岁 ，Python 将 打 
印 相 应 的 消息 , 并 跳 过 else 代码 块 。 如 果 if 测试 和 elif 测试 都 未 通过 , Python 将 运行 @ 人 处 else 
代码 块 中 的 代码 。 


在 本 例 中 , @ 处 测试 的 结果 为 False, 因此 不 执行 其 代码 块 。 然而 , 第 二 个 测试 的 结果 为 True 
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(12 小 于 18)， 因 此 执行 其 代码 块 。 输 出 为 一 个 句子 ， 向 用 户 指出 门票 价格 : 


Your admission cost is $25. 


只 要 年 龄 超过 17 岁 ， 前 两 个 测试 就 都 不 能 通过 。 在 这 种 情况 下 ， 将 执行 else 代码 块 ， 指 出 
门票 价格 为 40 美元 。 

为 了 让 代码 更 简洁 ， 可 不 在 if-elif-else 代码 块 中 打印 门票 价格 ， 而 只 在 其 中 设置 门票 价 
格 ， 并 在 它 后 面 添加 一 个 简单 的 函数 调用 print(): 


@ print(f"Your admission cost is ${price}.") 


@ 处 、@ 处 和 @ 处 的 代码 行 像 前 一 个 示例 那样 ， 根 据 人 的 年 龄 设置 变量 price 的 值 。 在 
if-elif-else 结构 中 设置 price 的 值 后 ， 一 条 未 缩 进 的 函数 调用 print()@ 会 根据 这 个 变量 的 值 
打印 一 条 消息 ， 指 出 门票 的 价格 。 

这 些 代码 的 输出 与 前 一 个 示例 相同 ,但 if-elif-else 结构 的 作用 更 小 : 它 只 确定 门票 价格 ， 
而 不 是 在 确定 门票 价格 的 同时 打印 一 条 消息 。 除 效率 更 高 外 ， 这 些 修订 后 的 代码 还 更 容易 修改 : 
要 调整 输出 消息 的 内 容 ， 只 需 修改 一 个 而 不 是 三 个 函数 调用 print()。 


5.3.4 使 用 多 个 elif 代码 块 


可 根据 需要 使 用 任意 数量 的 elif 代码 块 。 例 如 ， 假 设 前 述 游乐 场 要 给 老年 人 打折 ， 可 再 添 
加 一 个 条 件 测试 ， 判 断 顾 客 是 否 符 合 打 折 条 件 。 下 面 假设 对 于 65 岁 ( 含 ) 以 上 的 老人 ， 可 半价 
( 即 20 美 元 ) 购买 门票 


age = 12 


if age < 4: 

price = 0 
elif age < 18: 
price = 25 
@ elif age < 65: 
price = 40 
@ else: 
price = 20 


print(f"Your admission cost is ${price}.") 
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这 些 代码 大 多 未 变 。 第 二 个 elif 代码 块 ( 见 @ ) 通过 检查 确定 年 龄 不 到 65 岁 后 ， 才 将 门票 
价格 设置 为 全 票 价 格 一 一 40 美元 。 请 注意 , 在 else 代码 块 ( 见 @ ) 中 ,必须 将 所 赋 的 值 改 为 20， 
因为 仅 当 年 龄 超过 65 岁 ( 含 ) 时 ， 才 会 执行 这 个 代码 块 。 


5.3.5 省略 else 代码 块 


Python 并 不 要 求 if-elif 结构 后 面 必须 有 else 代码 块 。 在 有 些 情 况 下 ，else 代码 块 很 有 用 ; 
而 在 其 他 一 些 情况 下 ， 使 用 一 条 elif 语句 来 处 理 特定 的 情形 更 清晰 : 


age = 12 


if age < 4: 
price = 0 
elif age < 18: 
price = 25 
elif age < 65: 
price = 40 
@ elif age >= 65: 
price = 20 


print(f"Your admission cost is ${price}.") 


@ 处 的 elif 代码 块 在 顾客 的 年 龄 超过 65 岁 ( 含 ) 时 , 将 价格 设置 为 20 美元 。 这 上 比 使 用 else 
代码 块 更 清晰 些 。 经 过 这 样 的 修改 后 ， 每 个 代码 块 都 仅 在 通过 了 相应 的 测试 时 才 会 执行 。 

else 是 一 条 包罗 万 象 的 语句 ， 只 要 不 满足 任何 if 或 elif 中 的 条 件 测试 ， 其 中 的 代码 就 会 执 
行 。 这 可 能 引入 无 效 甚 至 恶意 的 数据 。 如 果 知 道 最终 要 测试 的 条 件 ， 应 考虑 使 用 一 个 elif 代码 
块 来 代替 else 代码 块 。 这 样 就 可 以 肯定 ， 仅 当 满 足 相 应 的 条 件 时 ， 代 码 才 会 执行 。 


5.3.6 测试 多 个 条 件 

if-elif-else 结构 功能 强大 , 但 仅 适 合用 于 只 有 一 个 条 件 满 足 的 情况 : 遇 到 通过 了 的 测试 后 ， 
Python 就 跳 过 余下 的 测试 。 这 种 行为 很 好 ， 效 率 很 高 ， 让 你 能 够 测试 一 个 特定 的 条 件 。 

然而 , 有 时 候 必 须 检查 你 关心 的 所 有 条 件 。 在 这 种 情况 下 , 应 使 用 一 系列 不 包含 elif 和 else 
代码 块 的 简单 if 语句 。 在 可 能 有 多 个 条 件 为 True 且 需 要 在 每 个 条 件 为 True 时 都 采取 相应 措施 
时 ， 适 合 使 用 这 种 方法 。 

下 面 再 来 看 看 前 面 的 比萨 店 示 例 。 如 果 顾 客 点 了 两 种 配料 ， 就 需要 确保 在 其 比萨 中 包含 这 些 
配料 : 


ioppings.py @ requested toppings = ['mushrooms', 'extra cheese'] 


@ if 'mushrooms' in requested toppings 
print("Adding mushrooms.") 
四 if 'pepperoni' in requested toppings 
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print("Adding pepperoni.") 
@ if 'extra cheese' jin requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizzal!") 


首先 创建 一 个 列表 ， 其 中 包含 顾客 点 的 配料 ( 见 @ )。@@ 处 的 if 语句 检查 顾客 是 否 点 了 配料 
蘑菇 ( mushrooms )。 如 果 点 了 ， 就 打印 一 条 确认 消息 。@ 处 检查 配料 辣 香 肠 ( pepperoni ) 的 代码 
也 是 一 个 简单 的 if 语句 ， 而 不 是 elif 或 else 语句 。 因 此 不 管 前 一 个 测试 是 否 通过 ， 都 将 进行 
这 个 测试 。@ 处 的 代码 检查 顾客 是 否 要 求 多 加 芝士 ( extra cheese )。 不 管 前 两 个 测试 的 结果 如 何 ， 
都 会 执行 这 些 代 码 。 每 当 这 个 程序 运行 时 ， 都 会 执行 这 三 个 独立 的 测试 。 

因为 本 例 检 查 了 每 个 条 件 ， 所 以 将 在 比萨 中 添加 蘑菇 并 多 加 芝士 : 


Adding mushrooms. 
Adding extra cheese. 


Finished making your pizzal 


如 果 像 下 面 这 样 转 而 使 用 if-elif-else 结构 ， 代 码 将 不 能 正确 运行 ， 因 为 有 一 个 测试 通 
就 会 跳 过 余下 的 测试 : 


位 


a 


requested toppings = ['mushrooms', 'extra cheese'] 


if 'mushrooms' in requested toppings: 
print("Adding mushrooms.") 

elif 'pepperoni' in requested toppings: 
print("Adding pepperoni.") 

elif 'extra cheese' in requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizza!") 


第 一 个 测试 检查 列表 中 是 否 包含 'mushrooms' 。 它 通过 了 ， 因 此 将 在 比萨 中 添加 芯 和 菇 。 然 而 ， 
Python 将 跳 过 if-elif-else 结构 中 余下 的 测试 ， 不 再 检查 列表 中 是 否 包 含 'pepperoni' 和 'extra 
cheese'。 结 果 是 ， 将 添加 顾客 点 的 第 一 种 配料 ， 但 不 会 添加 其 他 配料 : 


Adding mushrooms. 


Finished making your pizzal 


总 之 ， 如 果 只 想 执行 一 个 代码 块 ， 就 使 用 if-elif-else 结构 ; 如 果 要 执行 多 个 代码 块 ， 就 
使 用 一 系列 独立 的 if 语句 。 
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动手 试 一 斌 
练习 5-3: 外 星人 颜色 假设 在 游戏 中 刚 射 杀 了 一 个 外 星人 ， 请 创建 一 个 名 为 alien 
color 的 变量 ， 并 将 其 赋值 为 "green'、 "yellow' 或 'Ted '。 
口 编写 一 条 if 语句 ， 检 查 外 星人 是 否 是 绿色 的 。 如 果 是 ， 就 打印 一 条 消息 ， 指 出 
玩家 获得 了 5 分。 
口 编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 上 述 测试 通过 了 ， 而 在 另 一 个 版 本 中 
未 通过 (未 通过 测试 时 没有 输出 )。 
练习 5-4: 外 星人 颜色 2 像 练习 5-3 那样 设置 外 星人 的 颜色 ， 并 编写 一 个 if-else 
结构 。 
口 如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 因 射 杀 该 外 星人 获得 了 5 分 。 
口 如 果 外 星人 不 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 10 分 。 
口 编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 执行 if 代码 块 ， 在 另 一 个 版 本 中 执行 
else 代码 块 。 


练习 5-5: 外 星人 颜色 3 将 练习 5-4 中 的 if-else 结构 改 为 if-elif-else 结构 。 
口 如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 5 分 。 
口 如 果 外 星人 是 黄色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 10 分 。 


口 如 果 外 星人 是 红色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 15 分 。 
口 编写 这 个 程序 的 三 个 版 本 ， 分 别 在 外 星人 为 绿色 、 黄 色 和 红色 时 打印 一 条 消息 。 
练习 5-6: 人 生 的 不 同 阶段 ”设置 变量 age 的 值 ， 再 编写 一 个 if-elif-else 结构 ， 
根据 age 的 值 判 断 一 个 人 处 于 人 生 的 哪个 阶段 。 
口 如 果 年 龄 小 于 2 岁 ， 就 打印 一 条 消息 ， 指 出 这 个 人 是 婴儿 ，。 
口 如 果 年 龄 为 2( 含 ) ~4 岁 ， 就 打印 一 条 消息 ， 指 出 这 个 人 是 幼儿 。 
口 如 果 年 龄 为 4( 含 ) ~13 岁 ， 就 打印 一 条 消息 ， 指 出 这 个 人 是 儿童 。 
口 如 果 年 龄 为 13 ( 含 ) ~20 岁 ， 就 打印 一 条 消息 ， 指 出 这 个 人 是 青少年 。 
口 如 果 年 龄 为 20( 含 ) ~65 岁 ， 就 打印 一 条 消息 ， 指 出 这 个 人 是 成 年 人 。 
口 如 果 年 龄 超过 65 岁 ( 含 )， 就 打印 一 条 消息 ， 指 出 这 个 人 是 老年 人 。 
练习 5-7: 喜欢 的 水 果 ”创建 一 个 列表 ， 其 中 包含 你 喜欢 的 水 果 ， 再 编写 一 系列 独 
立 的 jf 语句， 检查 列表 中 是 否 包 含 特定 的 水 果 。 
口 将 该 列表 命名 为 favorite fruits， 并 在 其 中 包含 三 种 水 果 。 
口 编写 5 条 if 语句 ， 每 条 都 检查 某 种 水 果 是 否 包 含 在 列表 中 。 如 果 是， 就 打印 一 
条 消息 ， 下 面 是 一 个 例子 。 


You really like bananas! 
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5.4 使 用 if 语句 处 理 列表 


通过 结合 使 用 if 语句 和 列表 ， 可 完成 一 些 有 趣 的 任务 : 对 列表 中 特定 的 值 做 特殊 处 理 ; 高 
效 地 管理 不 断 变化 的 情形 , 如 和 餐馆 是 否 还 有 特定 的 食材 ; 证 明代 码 在 各 种 情形 下 都 将 按 预 期 那样 


运行 。 


5.4.1 检查 特殊 元 素 


本 章 开 头 通过 一 个 简单 示例 演示 了 如 何 处 理 特 殊 值 ' bmw' 一 一 它 需 要 采用 不 同 的 格式 进行 打 
印 。 现 在 你 对 条 件 测 试 和 if 语句 有 了 大 致 的 认识 ， 下 面 就 来 进一步 研究 如 何 检查 列表 中 的 特殊 
值 ， 并 对 其 做 合适 的 处 理 。 
继续 使 用 前 面 的 比 陕 店 示 例 。 这 家 比萨 店 在 制作 比萨 时 ， 每 添加 一 种 配料 都 打印 一 条 消息 。 
通过 创建 一 个 列表 , 在 其 中 包含 顾客 点 的 配料 ,并 使 用 一 个 循环 来 指出 添加 到 比萨 中 的 配料 ,能 
以 极 高 的 效率 编写 这 样 的 代码 : 


toppings.py requested toppings = ['mushrooms', 'green peppers', 'extra cheese'] 


for requested topping in requested toppings: 
print(f"Adding {requested topping}.") 


print("\nFinished making your pizzal!") 


输出 很 简单 ， 因 为 上 述 代码 不 过 是 一 个 简单 的 for 循环 : 


Adding mushrooms. 
Adding green peppers. 
Adding extra cheese. 


Finished making your pizzal 


然而 ， 如 果 比 萨 店 的 青椒 用 完了 ， 该 如 何 处 理 呢 ? 为 妥善 地 处 理 这 种 情况 , 可 在 for 循环 中 
包含 一 条 if 语句 : 


requested toppings = [ mushrooms ， "green peppers', 'extra cheese'] 


for requested topping in requested toppings: 
@ if requested topping == “green peppers ' : 
print("Sorry, we are out of green peppers right now.") 
@ else: 
print(f"Adding {requested topping}.") 


print("\nFinished making your pizza!") 


这 里 在 比萨 中 添加 每 种 配料 前 都 进行 检查 。@ 处 的 代码 检查 顾客 是 否 点 了 青椒 。 如 果 是 ， 就 
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显示 一 条 消息 ， 指 出 不 能 点 青椒 的 原因 。@ 处 的 else 代码 块 确保 其 他 配料 都 将 添加 到 比萨 中 。 
输出 表明 ， 已 经 妥善 地 处 理 了 顾客 点 的 每 种 配料 : 


Adding mushTooms . 
Sorry, we are out of green peppers right now. 
Adding extra cheese. 


Finished making your pizzal 


5.4.2 ”确定 列表 不 是 空 的 

到 目前 为 止 , 我 们 对 于 人 处理 的 每 个 列表 都 做 了 一 个 简单 的 假设 一 一 假设 它们 都 至 少 包含 一 个 
元 素 。 因 为 马上 就 要 让 用 户 来 提供 存储 在 列表 中 的 信息 , 所 以 不 能 再 假设 循环 运行 时 列表 不 是 空 
的 。 有 鉴于 此 ， 在 运行 for 循环 前 确定 列表 是 否 为 空 很 重要 。 

下 面 在 制作 比萨 前 检查 顾客 点 的 配料 列表 是 否 为 空 。 如 果 列 表 为 空 ,， 就 向 顾客 确认 是 否 要 点 
原味 比萨 ;如果 列表 不 为 空 ， 就 像 前 面 的 示例 那样 制作 比萨 : 


@ requested toppings = [] 


@ if requested toppings: 
for requested topping in requested toppings: 
print(f"Adding {requested topping}.") 
print("\nFinished making your pizza!") 
©@ else: 
print("Are you sure you want a plain pizza?") 


首先 创建 一 个 空 列表 ， 其 中 不 包含 任何 配料 ( 见 @ )。@ 处 进行 简单 的 检查 ， 而 不 是 直接 执 
行 for 循环 。 在 if 语句 中 将 列表 名 用 作 条 件 表达 式 时 ，Python 将 在 列表 至 少 包含 一 个 元 素 时 返 
回 True， 并 在 列表 为 空 时 返回 False。 如 果 requested toppings 不 为 空 ， 就 运行 与 前 一 个 示例 相 
同 的 for 循环 ; 否则 , 就 打印 一 条 消息 , 询问 顾客 是 否 确 实 要 点 不 加 任何 配料 的 原味 比萨 ( 见 @ )。 


在 这 里 ， 这 个 列表 为 空 ， 因 此 输出 如 下 一 一 询问 顾客 是 否 确实 要 点 原味 比 院 : 


Are you sure you want a plain pizza? 


如 果 这 个 列表 不 为 空 ， 输 出 将 显示 在 比萨 中 添加 的 各 种 配料 。 


5.4.3 ”使 用 多 个 列表 


顾客 的 要 求 往往 五 花 八 门 , 在 比萨 配料 方面 尤其 如 此 。 如 果 顾 客 要 在 比萨 中 添加 炸 苗条 , 该 
怎么 办 呢 ? 可 使 用 列表 和 if 语句 来 确定 能 否 满足 顾客 的 要 求 。 


来 看 看 在 制作 比萨 前 如 何 拒绝 怪异 的 配料 要 求 。 下 面 的 示例 定义 了 两 个 列表 , 其 中 第 一 个 列 
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表 包 含 比萨 店 供应 的 配料 ， 而 第 二 个 列表 包含 顾客 点 的 配料 。 这 次 对 于 requested_toppings 中 的 
每 个 元 素 ， 都 检查 它 是 否 是 比萨 店 供应 的 配料 ， 再 决定 是 否 在 比萨 中 添加 它 : 


@ available toppings = ['mushrooms', 'olives', 'green peppers', 
'pepperoni', 'pineapple', 'extra cheese'| 


@ requested toppings = ['mushrooms', 'french fries', 'extra cheese'] 


四 for requested topping in Tequested toppings 

0 if requested topping in available toppings 
print(f"Adding {requested topping}.") 

9 else: 
print(f"Sorry, we don't have {requested topping}.") 


print("\nFinished making your pizzal!") 


@ 处 定义 了 一 个 列表 ,其 中 包含 比萨 店 供应 的 配料 。 请 注意 ， 如 果 比 萨 店 供应 的 配料 是 固定 
的 ， 也 可 使 用 一 个 元 组 来 存储 它们 。@ 处 又 创建 了 一 个 列表 ,其 中 包含 顾客 点 的 配料 。 请 注意 那 
个 不 同 寻 常 的 配料 一 一 'french fries'。 在 @ 处 遍历 顾客 点 的 配料 列表 。 在 这 个 循环 中 ， 对 于 顾 
客 点 的 每 种 配料 ， 都 检查 它 是 否 包含 在 供应 的 配料 列表 中 ( 见 @ )。 如 果 答 案 是 肯定 的 ， 就 将 其 
加 入 比萨 中 ， 否 则 将 运行 else 代码 块 ( 见 @ ): 打印 一 条 消息 ， 告 诉 顾客 不 供应 这 种 配料 。 


这 些 代 码 的 输出 整洁 而 翔实 : 


Adding mushrooms. 
Sorry, we don't have french fries. 
Adding extra cheese. 


Finished making your pizzal 


通过 为 数 不 多 的 儿 行 代码 ， 我 们 高 效 地 处 理 了 一 种 真实 的 情形 ! 


动手 试 一 试 
练习 5-8: 以 特殊 方式 跟 管 理 员 打招呼 ”创建 一 个 至 少 包含 5 个 用 户 名 的 列表 ,上 且 
其 中 一 个 用 户 名 为 'admin'。 想 象 你 要 编写 代码 ， 在 每 位 用 户 登 录 网 站 后 都 打印 一 条 问 


候 消息 。 遍 历 用 户 名 列表 ， 并 向 每 位 用 户 打印 一 条 问候 消息 。 


口 如 果 用 户 名 为 'admin' ， 就 打印 一 条 特殊 的 问候 消息 ， 如 下 所 示 。 
Hello admin, would you like to see a status report? 

口 否则 ， 打 印 一 条 普通 的 问候 消息 ， 如 下 所 示 。 

Hello Jaden, thank you for logging in again. 
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练习 5-9: 处 理 没有 用 户 的 情形 在 为 完成 练习 5-8 编写 的 程序 中 ， 添 加 一 条 话语 
句 ， 检 查 用 户 名 列表 是 否 为 空 。 
口 如 果 为 空 ， 就 打印 如 下 消息 。 
We need to find some users! 
删除 列表 中 的 所 有 用 户 名 ， 确 定 将 打印 正确 的 消息 。 
练习 5-10: 检查 用 户 名 按 下 面 的 说 明 编 写 一 个 程序 ， 模 拟 网 站 如 何 确 保 每 位 用 户 
的 用 户 名 都 独一无二 。 
口 创建 一 个 至 少 包含 5 个 用 户 名 的 列表 ， 并 将 其 命名 为 current users。 
口 再 创建 一 个 包含 5 个 用 户 名 的 列表 ,将 其 命名 为 new users， 并 确保 其 中 有 一 两 
个 用 户 名 也 包含 在 列表 current users 中 。 
口 遍历 列表 new users, 对 于 其 中 的 每 个 用 户 名 , 都 检查 它 是 否 已 被 使 用 。 如果 是 ， 
就 打印 一 条 消息 ， 指 出 需要 输入 别 的 用 户 名 ; 否则 ， 打 印 一 条 消息 ， 指 出 这 个 
用 户 名 未 被 使 用 。 
口 确保 比较 时 不 区 分 大 小 写 。 换 和 句 话 说 ， 如 果 用 户 名 'John' 已 被 使 用 ， 应 拒绝 用 
户 名 'JOHN'。( 为 此 ， 需 要 创建 列表 current users 的 副本 ,其 中 包含 当前 所 有 
用 户 名 的 小 写 版 本 。) 
练习 5-11: 序数 ”序数 表示 位 置 ， 如 lst 和 2nd。 序 数 大 多 以 也 结尾 ， 只 有 1、 
和 3 例外 。 


口 在 一 个 列表 中 存储 数字 1 ~9。 

口 遍历 这 个 列表 。 

口 在 循环 中 使 用 一 个 if-elif-else 结构 ， 以 打印 每 个 数字 对 应 的 序数 。 输 出 内 容 
应 为 "1st 2nd 3rd 4th 5th 6th 7th 8th 9th"， 但 每 个 序数 都 独占 一 行 。 


5.5 设置 if 语句 的 格式 


本 章 的 每 个 示例 都 展示 了 良好 的 格式 设置 习惯 。 在 条 件 测试 的 格式 设置 方面 ，PEP 8 提供 自 
唯一 建议 是 ， 在 诸如 ==、>= 和 <= 等 比较 运算 符 两 边 各 添加 一 个 空格 。 例 如 : 


if age < 4: 


要 比 


if age<4: 


更 好 。 
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这 样 的 空格 不 会 影响 Python 对 代码 的 解读 ， 而 只 是 让 代码 阅读 起 来 更 容易 。 


动手 试 一 试 
练习 5-12: 设置 if 语句 的 格式 ”审核 你 在 本 章 编写 的 程序 ， 确 保 正 确 地 设置 了 条 
件 测试 的 格式 。 


练习 5-13: 自己 的 想法 与 刚 拿 起 本 书 时 相 比 ， 现 在 你 是 一 名 能 力 更 强 的 程序 员 
了 。 鉴 于 你 对 如 何在 程序 中 模拟 现实 情形 有 了 更 深入 的 认识 ， 可 以 考虑 使 用 程序 来 解决 
一 些 问 题 了 。 随 着 编程 技能 不 断 提高 ， 你 可 能 想 解 决 一 些 问题 ， 请 将 这 方面 的 想法 记录 
下 来 。 想 想 你 可 能 想 编写 的 游戏 、 想 研究 的 数据 集 以 及 想 创 建 的 Web 应 用 程序 。 


5.6 小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 编写 结果 要 么 为 True 要 么 为 False 的 条 件 测试 ， 如 何 编写 简单 
的 if 语句 、if-else 语句 和 if-elif-else 结构 ， 并 且 在 程序 中 使 用 这 些 结构 来 测试 特定 的 条 件 ， 
以 确定 这 些 条 件 是 否 满足 ; 如 何在 利用 高 效 的 for 循环 的 同时 ， 以 不 同 于 其 他 元 素 的 方式 对 特定 
的 列表 元 素 进 行 处 理 。 你 还 再 次 学 习 了 Python 就 代码 格式 提出 的 建议 ， 从 而 确保 即便 编写 的 程 
序 越 来 越 复 杂 ， 其 代码 依然 易于 阅读 和 理解 。 

在 第 6 章 ， 你 将 学 习 Python 字典 。 字 典 类 似 于 列表 ， 但 让 你 能 够 将 不 同 的 信息 关联 起 来 。 
你 将 学 习 如 何 创建 和 遍历 字典 ， 以 及 如 何 将 字典 同 列表 和 if 语句 结合 起 来 使 用 。 学 习 字 典 让 你 
能 够 模拟 更 多 现实 世界 的 情形 。 
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在 本 章 中 ， 你 将 学 习 能 够 将 相关 信息 关联 起 来 的 Python 字典 ， 
以 及 如 何 访问 和 修改 字典 中 的 信息 。 字 典 可 存储 的 信息 量 几乎 不 受 限 
制 ， 因 此 我 们 会 演示 如 何 遍历 字 典 中 的 数据 。 另 外 ,你 还 将 学 习 存 储 
字典 的 列表 、 存 储 列 表 的 字典 和 存储 字典 的 字典 。 

理解 字典 后 , 就 能 够 更 准确 地 为 各 种 真实 物体 建 模 。 你 可 以 创建 
一 个 表示 人 的 字典 , 然后 想 在 其 中 存储 多 少 信息 就 存储 多 少 信息 : 姓 
名 、 年 龄 、 地 址 、 职 业 ， 以 及 能 描述 他 的 任何 方面 。 你 还 能 够 存储 任 
意 两 种 相关 的 信息 ,如 一 系列 单词 及 其 含义 , 一 系列 人 名 及 其 喜欢 的 
数 ， 以 及 一 系列 山脉 及 其 海拔 ， 等 等 。 


6.1 一 个 简单 的 字典 闹 频 讲 角 
来 看 一 个 包含 外 星人 的 游戏 ， 这 些 外 星人 的 颜色 和 分 数 各 不 相同 。 下 面 是 一 个 简单 的 字典 ， 
存储 了 有 关 特 定 外 星人 的 信息 : 


alien.py alien 0 = {'color': 'green', 'points': 5} 


print(alien of'color']) 
print(alien Oo['points']) 


字典 alien_0 存储 了 外 星人 的 颜色 和 分 数 。 最 后 两 行 代码 访问 并 显示 这 些 信息 ， 结 果 如 下 : 


green 
5 


与 大 多 数 编程 概念 一 样 ， 要 熟练 使 用 字典 ， 也 需要 一 段 时 间 的 练习 。 使 用 字典 一 段 时 间 后 ， 
你 就 会 明白 为 何 它 们 能 够 高 效 地 模拟 现实 世界 中 的 情形 。 


在 Python 中 ， 字 典 是 一 系列 键 值 对 。 每 个 键 都 与 一 个 值 相关 联 ， 你 可 使 用 键 来 访问 相关 联 
的 值 。 与 键 相 关联 的 值 可 以 是 数 、 字 符 串 、 列 表 帮 至 字典 。 事 实 上 ， 可 将 任何 Python 对 象 用 作 
字典 中 的 值 。 


在 Python 中 ,字典 用 放 在 花 括 号 ({} ) 中 的 一 系列 键 值 对 表示 ， 如 前 面 的 示例 所 示 : 


alien 0 = {'color': 'green', 'points': 5} 


键 值 对 是 两 个 相关 联 的 值 。 指 定 键 时 , Python 将 返回 与 之 相关 联 的 值 。 键 和 值 之 间 用 冒号 分 
隔 ， 而 键 值 对 之 间 用 逗号 分 隔 。 在 字典 中 ， 想 存储 多 少 个 键 值 对 都 可 以 。 


最 简单 的 字典 只 有 一 个 键 值 对 ， 如 下 述 修改 后 的 字典 alien_0 所 示 : 


alien 0 = { color': 'green'} 


这 个 字典 只 存储 了 一 项 有 关 alien_0 的 信息 ， 具 体 地 说 是 这 个 外 星人 的 颜色 。 在 该 字典 中 ， 
字符 串 ' color ' 是 一 个 键 ， 与 之 相关 联 的 值 为 "green '。 


6.2.1 访问 字典 中 的 值 
要 获取 与 键 相关 联 的 值 ， 可 依次 指定 字典 名 和 放 在 方 括号 内 的 键 ， 如 下 所 示 : 


alien.py alien 0 = {'color': green '} 


print(alien 0[ "color']) 


这 将 返回 字典 alien_0 中 与 键 'color ' 相 关联 的 值 : 


green 


字典 中 可 包含 任意 数量 的 键 值 对 。 例 如 ， 下 面 是 最 初 的 字典 alien 0， 其 中 包含 两 个 键 值 对 : 


alien 0 = { color': 'green', 'points': 5} 


现在 ,你 可 访问 外 星人 alien_0 的 颜色 和 分 数 。 如 果 玩 家 射 杀 了 这 个 外 星人 ， 就 可 以 使 用 下 
面 的 代码 来 确定 应 获得 多 少 分 : 


alien 0 = {'color': 'green', 'points': 5} 


@ new points = alien 0['points '] 
@ print(f"You just earned {new points} points!") 
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上 述 代码 首先 定义 了 一 个 字典 。 然 后 ， 从 这 个 字典 中 获取 与 键 'points' 相 关联 的 值 ( 见 @ )， 
并 将 这 个 值 赋 给 变量 new_points。 接 下 来 ,将 这 个 整数 转换 为 字符 串 ， 并 打印 一 条 消息 ,指出 玩 
家 获得 了 多 少 分 ( 见 @ ): 


You just earned 5 points! 


如 果 在 外 星人 被 射 杀 时 运行 这 段 代码 ， 就 将 获取 该 外 星人 的 分 数 。 


6.2.2 ”添加 键 值 对 


字典 是 一 种 动态 结构 ， 可 随时 在 其 中 添加 键 值 对 。 要 添加 键 值 对 ， 可 依次 指定 字典 名 、 用 方 
括号 括 起 的 键 和 相关 联 的 值 。 


下 面 来 在 字典 alien_0 中 添加 两 项 信息 : 外 星人 的 x 坐 标 和 ?坐标 ， 让 我 们 能 够 在 屏幕 的 特 
定位 置 显示 该 外 星人 。 我 们 将 这 个 外 星人 放 在 屏幕 左边 缘 ， 且 离 屏幕 项 部 25 像素 的 地 方 。 由 于 
屏幕 坐标 系 的 原点 通常 为 左上 角 ， 要 将 该 外 星人 放 在 屏幕 左边 缘 ， 可 将 x 坐标 设置 为 0; 要 将 该 
外 星人 放 在 离 屏幕 顶部 25 像素 的 地 方 ， 可 将 ?坐标 设置 为 23 ， 如 下 所 示 : 


alien.py alien 0 = {'color': 'green', 'points': 5} 
print(alien 0) 


@ alien Oo['x position '] 
@ alien of'y position'] 
print(alien 0) 


= 0 
= 2 


5 


首先 定义 前 面 一 直 在 使 用 的 字典 ,然后 打印 这 个 字典 ， 以 显示 其 信息 快照 。 在 @ 处 , 我们 在 
这 个 字典 中 新 增 了 一 个 键 值 对 ， 其 中 的 键 为 'x_position' ， 值 为 0。 在 @ 处 重复 这 样 的 操作 ,但 
使 用 的 键 为 'y_position'。 打 印 修改 后 的 字典 时 ， 将 看 到 这 两 个 新 增 的 键 值 对 : 


{'color': 'green', 'points': 5} 
{'color': 'green', 'points': 5, 'x position': 0, 'y_position': 25} 


这 个 字典 的 最 终 版 本 包含 四 个 键 值 对 : 原来 的 两 个 指定 外 星人 的 颜色 和 分 数 ， 而 新 增 的 两 个 
指定 其 位 置 。 


注意 在 Python 3.7 中 ， 字 典 中 元 素 的 排列 顺序 与 定义 时 相同 。 如 果 将 字典 打印 出 来 或 遍历 其 


元 素 ， 将 发 现 元 素 的 排列 顺序 与 添加 顺序 相同 。 


6.2.3 先 创 建 一 个 空 字典 


在 空 字典 中 添加 键 值 对 有 时 候 可 提供 便利 ， 而 有 时 候 必须 这 样 做 。 为 此 ， 可 先 使 用 一 对 空 花 括 
号 定义 一 个 字典 ， 再 分 行 添加 各 个 键 值 对 。 例 如 ， 下 面 演示 了 如 何以 这 种 方式 创建 字典 alien_0: 
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alien.py alien 0 = {} 


alien 0['color'] = 'green' 
alien 0O['points'] = 5 


print(alien 0) 


这 里 首先 定义 了 空 字典 alien_0, 再 在 其 中 添加 颜色 和 分 数 , 得 到 前 述 示 例 一 直 在 使 用 的 字典 : 


{'color': 'green', 'points': 5} 


使 用 字典 来 存储 用 户 提 供 的 数据 或 在 编写 能 自动 生成 大 量 键 值 对 的 代码 时 , 通常 需要 先 定 义 


Fp 
一 个 空 字典 。 


6.2.4 修改 字典 中 的 值 


要 修改 字典 中 的 值 ， 可 依次 指定 字典 名 、 用 方 括号 括 起 的 键 ， 以 及 与 该 键 相关 联 的 新 值 。 例 
如 ， 假 设 随 着 游戏 的 进行 ， 需 要 将 一 个 外 星人 从 绿色 改 为 黄色 : 


alien.py alien 0 = {'color': 'green'} 
print(f"The alien is {alien of'color']}.") 


alien 0['color'] = 'yellow' 
print(f"The alien is now {alien Of'color']}.") 


首先 定义 一 个 表示 外 星人 alien_0 的 字典 ， 其 中 只 包含 这 个 外 星人 的 颜色 。 接 下 来 ， 将 与 键 
'color' 相 关联 的 值 改 为 'yellow' 。 输 出 表明 ， 这 个 外 星人 确实 从 绿色 变 成 了 黄色 : 


The alien is green. 
The alien is now yellow. 


来 看 一 个 更 有 趣 的 例子 ， 对 一 个 能 够 以 不 同 速度 移动 的 外 星人 进行 位 置 跟踪 。 为 此 , 我 们 将 
存储 该 外 星人 的 当前 速度 ， 并 据 此 确定 该 外 星人 将 向 右 移动 多 远 : 


alien 0 = {'x position': 0, 'y position': 25, "speed' : 'medium'} 
print(f"Original x position: {alien Of['x position']}") 


# 向 右 移动 外 星人 。 
# 根据 当前 速度 确定 将 外 星人 向 右 移动 多 远 。 
@ if alien of'speed'] == 'slow': 

x_increment = 1 

elif alien Of'speed'] == medium ' : 
x_increment = 2 

else: 
# 这 个 外 星人 的 移动 速度 肯定 很 快 。 
x_increment = 3 
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# 新 位 置 为 旧 位 置 如 上 移动 距离 。 
@ alien 0['x position'] = alien O['x position'] + x increment 


print(f"New x position: {alien O['x position']}") 


首先 定义 一 个 外 星人 ， 其 中 包含 初始 x 坐标 和 坐标， 还 有 速度 'medium'。 出 于 简化 考虑 ， 
省 略 了 颜色 和 分 数 , 但 即便 包含 这 些 键 值 对 ， 本 例 的 工作 原理 也 不 会 有 任何 变化 。 我们 还 打印 了 
x_position 的 初始 值 ， 旨 在 让 用 户 知 道 这 个 外 星人 向 右 移动 了 多 远 。 

@ 处 使 用 一 个 if-elif-else 结构 来 确定 外 星人 应 向 右 移动 多 远 ， 并 将 这 个 值 赋 给 变量 
x_increment。 如 果 外 星人 的 速度 为 'slow' ， 它 将 问 右 移动 一 个 单位 ; 如 果 速 度 为 'medium' ,将 向 
右 移 动 两 个 单位 ; 如 果 为 'fast' ， 将 向 右 移动 三 个 单位 。 确 定 移动 距离 后 ， 将 其 与 x_position 
的 当前 值 相 加 ( 见 @ )， 再 将 结果 关联 到 字典 中 的 键 x_ position。 

因为 这 是 一 个 速度 中 等 的 外 星人 ， 所 以 其 位 置 将 向 右 移 两 个 单位 : 


Original x-position: 0 
New x-position: 2 


这 种 技术 很 棒 : 通过 修改 外 星人 字典 中 的 值 ， 可 改变 外 星人 的 行为 。 例如， 要 将 这 个 速度 中 
等 的 外 星人 变 成 速度 很 快 的 外 星人 ， 可 添加 如 下 代码 行 : 


alien Of['speed'|] = 'fast' 


这 样 , 再 次 运行 这 些 代码 时 , 其 中 的 if-elif-else 结构 将 把 一 个 更 大 的 值 赋 给 变量 x_increment。 


6.2.5 ”删除 键 值 对 


对 于 字典 中 不 再 需要 的 信息 ， 可 使 用 del 语句 将 相应 的 键 值 对 彻底 删除 。 使 用 del 语句 时 ， 
必须 指定 字典 名 和 要 删除 的 键 。 


例如 ， 下 面 的 代码 从 字典 alien_0 中 删除 键 'points' 及 其 值 : 


alien.py alien 0 = { color': green'， 'points': 5} 
print(alien 0) 


@ del alien 0['points '] 
print(alien 0) 


@ 处 的 代码 行 让 Python 将 键 'points' 从 字典 alien 0 中 删除 ,同时 删除 与 这 个 键 相关 联 的 值 。 
输出 表明 ， 键 'points' 及 其 值 5 已 从 字典 中 删除 ， 但 其 他 键 值 对 未 受 影响 : 


{'color': 'green', 'points': 5} 
{'color': 'green'} 
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注意 ”删除 的 键 值 对 会 永远 消失 。 


6.2.6 ”由 类 似 对 象 组 成 的 字典 

在 前 面 的 示例 中 , 字典 存储 的 是 一 个 对 象 ( 游戏 中 的 一 个 外 星人 ) 的 多 种 信息 , 但 你 也 可 以 
使 用 字典 来 存储 众多 对 象 的 同一 种 信息 。 例 如, 假设 你 要 调查 很 多 人 , 询问 他 们 最 喜欢 的 编程 语 
言 ， 可 使 用 一 个 字典 来 存储 这 种 简单 调查 的 结果 ， 如 下 所 示 : 


favorite languages = { 
‘jen': 'python', 
"sarah’ 2 “e, 
‘edward': 'ruby', 
‘phil': 'python’', 
} 


如 你 所 见 , 我 们 将 一 个 较 大 的 字典 放 在 了 多 行 中 。 每 个 键 都 是 一 个 被 调查 者 的 名 字 ， 而 每 个 
值 都 是 被 调查 者 喜欢 的 语言 。 确 定 需 要 使 用 多 行 来 定义 字典 时 ， 要 在 输入 左 花 括号 后 按 回 车 键 。 
在 下 一 行 缩 进 四 个 空格 ,指定 第 一 个 键 值 对 ， 并 在 它 后 面 加 上 一 个 去 号 。 此 后 再 按 回 车 键 时 ， 文 
本 编辑 器 将 自动 缩 进 后 续 键 值 对 ， 且 缩 进 量 与 第 一 个 键 值 对 相同 。 

定义 好 字典 后 , 在 最 后 一 个 键 值 对 的 下 一 行 添 加 一 个 右 花 括 号 , 并 缩 进 四 个 空格 , 使 其 与 字 
典 中 的 键 对 齐 。 一 种 不 错 的 做 法 是 , 在 最 后 一 个 键 值 对 后 面 也 加 上 逗号 , 为 以 后 在 下 一 行 添 加 键 
值 对 做 好 准备 。 


注意 ”对 于 较 长 的 列表 和 字典 ， 大 多 数 编辑 器 提供 了 以 类 似 方式 设置 格式 的 功能 。 对 于 较 长 的 
字典 ， 还 有 其 他 一 些 可 行 的 格式 设置 方式 ， 因 此 在 你 的 编辑 器 或 其 他 源 代码 中 ， 你 可 能 
会 看 到 稍微 不 同 的 格式 设置 方式 。 


给 定 被 调查 者 的 名 字 ， 可 使 用 这 个 字典 轻松 地 获悉 他 喜欢 的 语言 : 


fovorile favorite languages = { 


languages.py 'jen': 'python', 
" Srah Cs 
‘edward' : 'ruby', 
'phil': 'python', 


@ language = favorite languages['sarah'].title() 
print(f"Sarah's favorite language is {language}.") 


为 获悉 Sarah 喜欢 的 语言 ， 我 们 使 用 如 下 代码 : 


favorite languages[ sarah '] 
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在 @ 处 ， 使 用 这 种 语法 获取 Sarah 喜欢 的 语言 ， 并 将 其 赋 给 变量 language。 创 建 这 个 新 变量 


让 函数 调用 print() 变 得 整洁 得 多 。 输 出 指出 了 Sarah 喜欢 的 语言 : 


Sarah's favorite language is C. 


这 种 语法 可 用 来 从 字典 中 获取 任何 人 喜欢 的 语言 。 


6.2.7 ”使 用 get() 来 访问 值 


使 用 放 在 方 括号 内 的 键 从 字典 中 获取 感 兴趣 的 值 时 , 可 能 会 引发 问题 : 如 果 指 定 的 键 不 存在 


就 会 出 错 。 


alien_no_ 


points.py 


如 果 你 要 求 获取 外 星人 的 分 数 ， 而 这 个 外 星人 没有 分 数 ， 结 果 将 如 何 呢 ? 下 面 来 看 一 看 : 


alien 0 = { color': green'， 'speed': 'slow'} 
print(alien 0[ "points ']) 


这 将 导致 Python 显示 traceback， 指 出 存在 键 值 错误 (KeyError ): 


Traceback (most recent call last): 
File "alien no points.py", line 2, in <module> 
print(alien 0[ 'points']) 
KeyError: 'points’ 


第 10 章 将 详细 介绍 如 何 处 理 类 似 的 错误 , 但 就 字典 而 言 , 可 使 用 方法 get() 在 指定 的 键 不 存 


在 时 返回 一 个 默认 值 ， 从 而 避免 这 样 的 错误 。 


方法 get() 的 第 一 个 参数 用 于 指定 键 ， 是 必 不 可 少 的 ; 第 二 个 参数 为 指定 的 键 不 存在 时 要 返 


回 的 值 ， 是 可 选 的 : 


alien 0 = { color': 'green', 'speed': 'slow'} 


point value = alien 0.get('points', "No point value assigned.) 
print(point value) 


如 果 字 典 中 有 键 'points' ， 将 获得 与 之 相关 联 的 值 ; 如 果 没 有 ， 将 获得 指定 的 默认 值 。 虽然 


这 里 没有 键 'points' ,但 将 获得 一 条 清晰 的 消息 ， 不 会 引发 错误 : 


No point value assigned. 


如 果 指 定 的 键 有 可 能 不 存在 ， 应 考虑 使 用 方法 get() ， 而 不 要 使 用 方 括号 表示 法 。 


Re 
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谢 


注意 调用 get() 时 ， 如 果 没有 指定 第 二 个 参数 且 指 定 的 键 不 存在 ，Python 将 返回 值 None。 这 
个 特殊 值 表 示 没 有 相应 的 值 。None 并 非 错 误 ， 而 是 一 个 表示 所 需 值 不 存在 的 特殊 值 ， 第 


8 章 将 介绍 它 的 其 他 用 途 。 


动手 试 一 斌 


练习 6-1: 人 ”使 用 一 个 字典 来 存储 一 个 熟人 的 信息 ， 包 括 名 、 姓 、 年 龄 和 居住 的 
城市 。 该 字典 应 包含 键 first_name、last_name、age 和 city。 将 存储 在 该 字典 中 的 每 项 
信息 都 打印 出 来 。 

练习 6-2: 喜欢 的 数 ”使 用 一 个 字典 来 存储 一 些 人 喜欢 的 数 。 请 想 出 5 个 人 的 名 字 ， 
并 将 这 些 名 字 用 作 字 典 中 的 键 ; 找 出 每 个 人 喜欢 的 一 个 数 ， 并 将 这 些 数 作为 值 存储 在 字 
典 中 。 打印 每 个 人 的 名 字 和 喜欢 的 数 。 为 了 让 这 个 程序 更 有 趣 ， 通过 询问 朋友 确保 数据 


是 真实 的 。 
练习 6-3: 词汇 表 Python 字典 可 用 于 模拟 现实 生活 中 的 字典 。 为 避免 混淆 ， 我 们 
将 后 者 称 为 词汇 表 。 
口 想 出 你 在 前 面 学 过 的 5 个 编程 术语 ， 将 其 用 作词 汇 表 中 的 键 ， 并 将 它们 的 含义 
作为 值 存储 在 词汇 表 中 。 
口 以 整洁 的 方式 打印 每 个 术语 及 其 含义 。 为 此 ， 可 先 打 印 术 语 ， 在 它 后 面 加 上 一 
个 冒号 ， 再 打印 其 含义 ; 也 可 在 一 行 打印 术语 ， 再 使 用 换行 符 〈\n ) 插入 一 个 
空 行 ， 然 后 在 下 一 行 以 缩 进 的 方式 打印 其 含义 。 


6.3 遍历 字典 


一 个 Python 字典 可 能 只 包含 几 个 键 值 对 ， 也 可 能 包含 数 百 万 个 键 值 对 。 鉴 于 字典 可 能 包含 
大 量 数据 , Python 支持 对 字典 进行 遍历 。 字典 可 用 于 以 各 种 方式 存储 信息 , 因此 有 多 种 遍历 方式 : 
可 遍历 字典 的 所 有 键 值 对 ， 也 可 仪 遍 历 键 或 值 。 


6.3.1 遍历 所 有 键 值 对 


探索 各 种 遍历 方法 前 ， 先 来 看 一 个 新 字典 ， 它 用 于 存储 有 关 网 站 用 户 的 信息 。 下 面 的 字典 存 
储 一 名 用 户 的 用 户 名 、 名 和 姓 : 


user 0 = 
'username': 'efermi', 
"first': 'enrico', 


"last': 'fermi', 


} 


利用 本 章 前 面 介绍 过 的 知识 ， 可 访问 user 0 的 任何 一 项 信息 ,但 如 果 要 获悉 该 用 户 字典 中 
的 所 有 信息 ， 该 如 何 办 呢 ? 可 使 用 for 循环 来 遍历 这 个 字典 : 


userpy User 0 = 二 


'username': 'efermi', 
"first': 'enrico', 
“ast "termi”s 


@ for key, value in user 0.items(): 
© print(f"\nKkey: {key}") 
(3 print(f"Value: {value}") 


如 @ 所 示 ， 要 编写 遍历 字典 的 for 循环 ， 可 声明 两 个 变量 ， 用 于 存储 键 值 对 中 的 键 和 值 。 这 
两 个 变量 可 以 使 用 任意 名 称 。 下 面 的 代码 使 用 了 简单 的 变量 名 ， 这 完全 可 行 : 


for k, v in user 0.items() 


for 语句 的 第 二 部 分 包含 字典 名 和 方法 items()( 见 @ )， 它 返回 一 个 键 值 对 列表 。 接 下 来 ， 
for 循环 依次 将 每 个 键 值 对 赋 给 指定 的 两 个 变量 。 在 本 例 中 ， 使 用 这 两 个 变量 来 打印 每 个 键 ( 见 @ ) 
及 其 相关 联 的 值 ( 见 @ )。 第 一 个 函数 调用 print() 中 的 "\n" 确 保 在 输出 每 个 键 值 对 前 都 插入 一 个 


2 
Di 
空 行 : 


Key: username 
Value: efermi 


Key: first 
Value: enrico 


Key: last 
Value: fermi 


在 6.2.6 节 的 示例 favorite_languages.py 中 ， 字 — 典 存储 的 是 不 同人 的 同一 种 信息 。 对 于 类 似 这 
样 的 字典 ， 遍 历 所 有 的 键 值 对 很 合适 。 如 果 遍 历 字 典 favorite_ languages， 将 得 到 其 中 每 个 人 的 
姓名 和 喜欢 的 编程 语言 。 由 于 该 字典 中 的 键 都 是 人 名 , 值 都 是 语言 , 因此 在 循环 中 使 用 变量 name 
和 language， 而 不 是 key 和 value。 这 让 人 更 容易 明白 循环 的 作用 : 


favorite” favorite languages = { 
languages.py 'jen': 'python', 
"ara Co 
‘edward': 'ruby', 
'phil': 'python', 
} 
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7 ~ 


@ for name, language in favorite languages.items(): 
@ print(f"{name.title()}'s favorite language is {language.title()}.") 


@ 处 的 代码 让 Python 遍历 字典 中 的 每 个 键 值 对 ， 并 将 键 赋 给 变量 name ， 将 值 赋 给 变量 
language。 这 些 描述 性 名 称 能 够 让 人 非常 轻松 地 明白 函数 调用 print()( 见 @ ) 是 做 什么 的 。 


仅 使 用 几 行 代码 ， 就 将 全 部 调查 结果 显示 出 来 了 : 


Jen's favorite language is Python . 
Sarah's favorite language is C. 

Edward's favorite language is Ruby. 
Phil's favorite language is Python. 


即便 字典 存储 的 是 上 千 乃 至 上 百 万 人 的 调查 结果 ， 这 种 循环 也 管用 。 


6.3.2 ”遍历 字典 中 的 所 有 键 


在 不 需要 使 用 字典 中 的 值 时 , 方法 keys() 很 有 用 。 下 面 来 遍历 字典 favorite_languages， 并 
将 每 个 被 调查 者 的 名 字 都 打印 出 来 : 


favorite languages = { 


'jen': “python ， 
‘sarah GE 

‘edward': “Tuby ， 
“phil : "python ， 


1 
4 


@ for name in favorite languages.keys(): 
print(name.title()) 


@ 处 的 代码 行 让 Python 提取 字典 favorite languages 中 的 所 有 键 ， 并 依次 将 它们 赋 给 变量 
name。 输 出 列 出 了 每 个 被 调查 者 的 名 字 : 


Jen 
Sarah 
Edward 
Phil 


遍历 字典 时 ,会 默认 遍历 所 有 的 键 。 因 此 ， 如 果 将 上 述 代码 中 的 : 


for name in favorite languages: 


替换 为 : 


for name in favorite languages.keys(): 


输出 将 不 变 。 
显 式 地 使 用 方法 keys() 可 让 代码 更 容易 理解 ， 你 可 以 选择 这 样 做 , 但 是 也 可 以 省 上 略 它 。 


在 这 种 循环 中 ,可 使 用 当前 键 来 访问 与 之 相关 联 的 值 。 下 面 来 打印 两 条 消息 ,指出 两 位 朋友 
喜欢 的 语言 。 像 前 面 一 样 遍历 字典 中 的 名 字 , 但 在 名 字 为 指定 朋友 的 名 字 时 ,打印 一 条 消息 , 指 
出 其 喜欢 的 语言 : 


favorite languages = { 


-- Snip-- 
} 
@ friends = ['phil', 'sarah'] 
for name in favorite languages.keys(): 
print(f"Hi {name.title()}.") 
@ if name in friends: 
@ language = favorite languages[namel].title() 


print(f"\t{name.title()}, I see you love {language}!") 


@ 处 创建 了 一 个 列表 ， 其 中 包含 要 收 到 打印 消息 的 朋友 。 在 循环 中 ， 打 印 每 个 人 的 名 字 ， 并 
检查 当前 的 名 字 是 否 在 列表 friends 中 ( 见 @ )。 如 果 在 ， 就 打印 一 句 特殊 的 问候 语 ， 其 中 包含 这 
位 朋友 喜欢 的 语言 。 为 获悉 朋友 喜欢 的 语言 ， 我 们 使 用 了 字典 名 ， 并 将 变量 name 的 当前 值 作为 
键 ( 见 @ )。 


每 个 人 的 名 字 都 会 被 打印 ， 但 只 对 朋友 打 特殊 消息 : 


Hi Jen. 
Hi Sarah. 
Sarah, I see you love C! 
Hi Edward. 
Hi Phil. 
Phil, I see you love Python! 


还 可 使 用 方法 keys() 确 定 某 个 人 是 否 接 受 了 调查 。 下 面 的 代码 确定 Erin 是 否 接受 了 调查 : 


favorite languages = { 
'jen': 'python', 
"sarah ee. “e 
‘edward': 'ruby', 
'phil': 'python', 
} 


@ if 'erin' not in favorite languages.keys(): 
print("Erin, please take our poll!") 


方法 keys() 并 非 只 能 用 于 遍历 : 实际 上 , 它 返 回 一 个 列表 , 其 中 包含 字典 中 的 所 有 键 。 因 此 
@ 处 的 代码 行 只 核实 'erin' 是 否 包 含 在 这 个 列表 中 。 因 为 她 并 不 包含 在 这 个 列表 中 ， 所 以 打印 一 
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条 消息 ， 邀 请 她 参加 调查 : 


Erin, please take our poll! 


6.3.3 ” 按 特定 顺序 遍历 字典 中 的 所 有 键 

从 Python 3.7 起 ， 遍 历 字典 时 将 按 插入 的 顺序 返回 其 中 的 元 素 。 不 过 在 有 些 情 况 下 ， 你 可 能 
要 按 与 此 不 同 的 顺序 遍历 字典 。 

要 以 特定 顺序 返回 元 素 ,一 种 办 法 是 在 for 循环 中 对 返回 的 键 进行 排序 。 为 此 ,可 使 用 函数 
sorted() 来 获得 按 特定 顺序 排列 的 键 列表 的 副本 : 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
‘edward': 'ruby', 
"phil : 'python', 
} 


for name in sorted(favorite languages.keys()): 
print(f"{name.title()}, thank you for taking the poll.") 


这 条 for 语句 类 似 于 其 他 for 语句 ， 不 同 之 处 是 对 字典 方法 keys() 的 结果 调用 了 函数 sorted()。 
这 让 Python 列 出 字典 中 的 所 有 键 ， 并 在 遍历 前 对 这 个 列表 进行 排序 。 输 出 表明 ， 按 顺序 显示 了 
所 有 被 调查 者 的 名 字 : 


Edward, thank you for taking the poll. 
Jen, thank you for taking the poll. 
Phil, thank you for taking the poll. 
Sarah, thank you for taking the poll. 


6.3.4 ”遍历 字典 中 的 所 有 值 

如 果 主 要 对 字典 包含 的 值 感 兴趣 ， 可 使 用 方法 values() 来 返回 一 个 值 列 表 ， 不 包含 任何 键 。 
例如 ,假设 我 们 想 获 得 一 个 列表 ， 其 中 只 包含 被 调查 者 选择 的 各 种 语言 ， 而 不 包含 被 调查 者 的 名 
字 ， 可 以 这 样 做 : 


favorite languages = { 


'jen': 'python', 
"Saratie we, 
‘edward': 'ruby', 
'phil': 'python', 


J 


print("The following languages have been mentioned:") 


for language in favorite languages.values(): 
print(language.title()) 


这 条 for 语句 提取 字典 中 的 每 个 值 ， 并 将 其 依次 赋 给 变量 language。 通 过 打印 这 些 值 ， 就 获 
得 了 一 个 包含 被 调查 者 所 选择 语言 的 列表 : 


The following languages have been mentioned: 
Python 

E 

Ruby 

Python 


这 种 做 法 提取 字典 中 所 有 的 值 ， 而 没有 考虑 是 否 重复 。 涉 及 的 值 很 少时 ， 这 也 许 不 是 问题 ， 
但 如 果 被 调查 者 很 多 ， 最 终 的 列表 可 能 包含 大 量 重复 项 。 为 剔除 重复 项 ， 可 使 用 集合 〈set )。 
集合 中 的 每 个 元 素 都 必须 是 独一无二 的 : 


favorite languages = { 
-- Snip-- 


} 


print("The following languages have been mentioned:") 
@ for language in set(favorite languages.values()): 
print(language.title()) 


通过 对 包含 重复 元 素 的 列表 调用 set(), 可 让 Python 找 出 列表 中 独一无二 的 元 素 , 并 使 用 这 
些 元 素来 创建 一 个 集合 。@ 处 使 用 set() 来 提取 favorite languages.values() 中 不 同 的 语言 。 


结果 是 一 个 不 重复 的 列表 ， 其 中 列 出 了 被 调查 者 提 及 的 所 有 语言 : 


The following languages have been mentioned : 
Python 

GE 

Ruby 


随 着 你 更 深入 地 学 习 Python， 经 党 会 发 现 它 内 置 的 功能 可 帮助 你 以 希望 的 方式 处 理 数据 。 


注意 ”可 使 用 一 对 花 括 号 直接 创建 集合 ， 并 在 其 中 用 去 号 分 隔 元 素 : 


>>> languages = {'python', 'ruby', 'python'’, 'c'} 
>>> languages 
{'ruby', 'python'’, 'c'} 


容易 混 消 ， 因 为 它们 都 是 用 一 对 花 括 号 定义 的 。 当 花 括 号 内 没有 键 值 对 时 ， 
的 很 可 能 是 集合 。 不 同 于 列表 和 字典 ， 集 合 不 会 以 特定 的 顺序 存储 元 素 。 


动手 试 一 斌 


练习 6-4: 词汇 表 2 现在 你 知道 了 如 何 遍历 字典 ， 可 以 整理 为 完成 练习 6-3 而 编写 
的 代码 ， 将 其 中 的 一 系列 函数 调用 print() 蔡 换 为 一 个 遍历 字典 中 键 和 值 的 循环 。 确 定 
该 循环 正确 无 误 后 ， 再 在 词汇 表 中 添加 5 个 Python 术语 。 当 你 再 次 运行 这 个 程序 时 ， 
这 些 新 术语 及 其 含义 将 自动 包含 在 输出 中 。 

练习 6-5: 河流 创建 一 个 字典 ， 在 其 中 存储 三 条 重要 河流 及 其 流 经 的 国家 。 例 如 ， 
一 个 键 值 对 可 能 是 'nile': 'egypt'。 
口 使 用 循环 为 每 条 河流 打印 一 条 消息 ， 下 面 受 三 个 合子。 


The Nile runs through Egypt. 

口 使 用 循环 将 该 字典 中 每 条 河流 的 名 字 打 印 出 来 。 

口 使 用 循环 将 该 字典 包含 的 每 个 国家 的 名 字 打 印 出 来 。 

练习 6-6: 调查 在 6.3.1 节 编写 的 程序 favorite languages.py 中 执行 以 下 操作 。 

口 创建 一 个 应 该 会 接受 调查 的 人 员 名 单 ， 其 中 有 些 人 已 包含 在 字典 中 ， 而 其 他 人 
未 包含 在 字典 中 。 

口 遍历 这 个 人 员 名 单 。 对 于 已 参与 调查 的 人 ， 打 印 一 条 消息 表示 感谢 ; 对 于 还 未 
参与 调查 的 人 ， 打 印 一 条 消息 邀请 他 参加 。 


6.4 ” 藤 套 


有 时 候 ， 需 要 将 一 系列 字典 存储 在 列表 中 ， 或 将 列表 作为 值 存储 在 字典 中 ， 这 称 为 能 套 。 你 
可 以 在 列表 中 内 套 字典 、 在 字典 中 内 套 列表 甚至 在 字典 中 内 套 字典 。 正 如 下 面 的 示例 将 演示 的 ， 
区 套 是 一 项 强大 的 功能 。 


6.4.1 字典 列表 


字典 alien_0 包含 一 个 外 星人 的 各 种 信息 ， 但 无 法 存储 第 二 个 外 星人 的 信息 ， 更 别 说 屏幕 上 
全 部 外 星人 的 信息 了 。 如 何 管理 成 群 结 队 的 外 星人 呢 ? 一 种 办 法 是 创建 一 个 外 星人 列表 , 其 中 每 
个 外 星人 都 是 一 个 字典 , 包含 有 关 该 外 星人 的 各 种 信息 。 例 如 , 下面 的 代码 创建 一 个 包含 三 个 外 
星人 的 列表 : 


aliens.py alien 0 = {'color': 'green', 'points': 5} 
alien 1 = {'color': 'yellow', 'points': 10} 
alien 2 = {'color': 'red', 'points': 15} 


@ aliens = [alien 0, alien 1, alien 2] 
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for alien in aliens: 


print(alien) 


首先 创建 三 个 字典 ,其 中 每 个 字典 都 表示 一 个 外 星人 。 然 后 在 @ 处 将 这 些 字典 都 存储 到 一 个 


名 为 aliens 的 列表 中 。 最 后 ， 遍 历 这 个 列表 ， 并 将 每 个 外 星人 都 打印 出 来 : 


{'color': 'green', 'points': 5} 
{'color': 'yellow', 'points': 10} 


{'color': 'red', 'points': 15} 


更 符合 现实 的 情形 是 , 外 星人 不 止 三 个 , 且 每 个 外 星人 都 是 使 用 代码 自动 生成 的 。 在 下 面 的 


示例 中 ,使 用 range() 生 成 了 30 个 外 星人 : 


# 创建 一 个 用 于 存储 外 星人 的 空 列表 。 


aliens = [] 


# 创建 30 个 绿色 的 外 星人 。 


for a 


al 


# 显示 前 5 个 外 星人 。 
lien in aliens[:5]: 


@fora 
print(alien) 
Pri Cs 


# 显示 创建 了 多 少 个 外 星人 。 


©@ print 


@ lien number in range(30) 
© new alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
© iens.append(new alien) 


f"Total number of aliens: {len(aliens)}") 


在 本 例 中 ， 首 先 创建 一 个 空 列表 ， 用 于 存储 接 下 来 将 创建 的 所 有 外 星人 。 在 @ 人 处 ，range() 
返回 一 系列 数 ， 其 唯一 的 用 途 是 告诉 Python 要 重复 这 个 循环 多 少 次 。 每 次 执行 这 个 循环 时 ， 都 
创建 一 个 外 星人 ( 见 @ )， 并 将 其 附加 到 列表 aliens 末尾 ( 见 @ ), 在 @ 处 , 使 用 一 个 切片 来 打印 


前 5 个 外 星人 。 在 人 @ 处 ， 打 印 列表 的 长 度 ， 以 证 明确 实 创建 了 30 个 外 星人 : 


{'co 
{'co 
{'co 
人 ED 
{'co 


Tota 


or': 
oF: 
OP 
OF 
OF 


'green’ 
'green’ 
'green’ 
'green’ 
'green’ 


i 


"points : 
"points : 
"points : 
"points : 
"points : 


number of aliens: 30 


"Speed ' : 
“Speed ' : 
“Speed ' : 
“Speed ' : 
“Speed ' : 


slow'} 
slow'} 
slow'} 
slow'} 
slow'} 


这 些 外 星人 都 具有 相同 的 特征 ， 但 在 Python 看 来 ， 每 个 外 星人 都 是 独立 的 ， 这 让 我 们 能 够 


独立 地 修改 每 个 外 星人 。 
在 什么 情况 下 需要 人 处理 成 群 结 队 的 外 星人 呢 ?” 想 象 一 下 , 可 能 随 着 游戏 的 进行 , 有 些 外 星人 


96 第 6 章 字典 


会 变色 且 加 快 移动 速度 。 必 要 时 ， 可 使 用 for 循环 和 if 语句 来 修改 某 些 外 星人 的 颜色 。 例 如 ， 
要 将 前 三 个 外 星人 修改 为 黄色 、 速 度 为 中 等 是 值 10 分， 可 这 样 做 : 


# 创建 一 个 用 于 存储 外 星人 的 空 列 表 。 
aliens = [|] 


# 创建 30 个 绿色 的 外 星人 

for alien number in range (30): 
new alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
aliens.append(new alien) 


for alien in aliens[:3]: 


if alien['color'] == "green : 
alien[ "color '] = 'yellow' 
alien[ "speed ] = "medium' 
alien[ ' points ] = 10 


# 显示 前 5 个 外 星人 ， 

for alien in aliens[:5]: 
print(alien) 

print( se) 


鉴于 要 修改 前 三 个 外 星人 , 我 们 遍历 一 个 只 包含 这 些 外 星人 的 切片 。 当 前 ,所 有 外 星人 都 是 
绿色 的 ， 但 情况 并 非 总 是 如 此 ， 因 此 编写 一 条 if 语句 来 确保 只 修改 绿色 外 星人 。 如 果 外 星人 是 
绿色 的 ， 就 将 其 颜色 改 为 yellow' ,将 其 速度 改 为 'medium' ， 并 将 其 分 数 改 为 10， 如 下 面 的 输出 
所 示 : 


{ color ' : 'yellow', "points': 10, 'speed': “medium 
{ color ' : 'yellow', "points': 10, 'speed': “medium 
{ color ' : 'yellow', "points': 10, 'speed': medium 
{'color': 'green', 'points': 5, 'speed': 'slow'} 
{'color': 'green', 'points': 5, 'speed': 'slow'} 


可 进一步 扩展 这 个 循环 ， 在 其 中 添加 一 个 elif 代码 块 ， 将 黄色 外 星人 改 为 移动 速度 快 且 值 
15 分 的 红色 外 星人 ， 如 下 所 示 ( 这 里 只 列 出 了 循环 ， 而 没有 列 出 整个 程序 ): 


for alien in aliens[0:3]: 

if alien['color'] == 'green': 
alien[ 'color'] = 'yellow' 
alien[' speed ] = 'medium’' 
alien[ ' points'] = 10 
elif alien['color'] == "yellow ': 
alien[" color '] 
alien[ “speed ] 
alien[ "points'] = 15 


经 常 需要 在 列表 中 包含 大 量 的 字典 ， 而 其 中 每 个 字典 都 包含 特定 对 象 的 众多 信息 。 例 如 , 你 
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可 能 需要 为 网 站 的 每 个 用 户 创建 一 个 字典 ( 就 像 6.3.1 节 的 userpy 中 那样 )， 并 将 这 些 字典 存储 
在 一 个 名 为 users 的 列表 中 。 在 这 个 列表 中 , 所 有 字典 的 结构 都 相同 , 因此 你 可 以 遍历 这 个 列表 ， 
并 以 相同 的 方式 处 理 其 中 的 每 个 字典 。 


6.4.2 ”在 字典 中 存储 列表 


有 时 候 , 需要 将 列表 存储 在 字典 中 ， 而 不 是 将 字典 存储 在 列表 中 。 例如， 你 如 何 描述 顾客 点 
的 比萨 呢 ? 如 果 使 用 列表 ， 只 能 存储 要 添加 的 比萨 配料 ; 但 如 果 使 用 字典 , 就 不 仅 可 在 其 中 包含 
配料 列表 ， 还 可 包含 其 他 有 关上 比萨 的 描述 。 

在 下 面 的 示例 中 ， 存 储 了 比萨 的 两 方面 信息 : 外 皮 类 型 和 配料 列表 。 配 料 列表 是 一 个 与 键 
'toppings' 相 关联 的 值 。 要 访问 该 列表 ， 我 们 使 用 字典 名 和 键 'toppings' ， 就 像 访问 字典 中 的 其 
他 值 一 样 。 这 将 返回 一 个 配料 列表 ， 而 不 是 单个 值 : 


pizza.py # 存储 所 点 比萨 的 信息 。 
@ pizza = { 
‘crust': 'thick', 
'toppings': ['mushrooms', 'extra cheese'], 


# 概述 所 点 的 比萨 。 
@ print(f"You ordered a {pizza['crust']}-crust pizza ' 
"with the following toppings:") 


@ for topping in pizzal['toppings']: 
print("\t" + topping) 


首先 创建 一 个 字典 ， 其 中 存储 了 有 关 顾 客 所 点 比萨 的 信息 ( 见 @ )。 在 这 个 字典 中 ， 一 个 键 
是 'crust' ,与 之 相关 联 的 值 是 字符 串 'thick' ; 下 一 个 键 是 'toppings' ， 与 之 相关 联 的 值 是 一 个 
列表 ， 其 中 存储 了 顾客 要 求 添加 的 所 有 配料 。 制 作 前 ， 我 们 概述 了 顾客 所 点 的 比萨 ( 见 @@ )。 如 
果 函 数 调 用 print() 中 的 字符 串 很 长 ， 可 以 在 合适 的 位 置 分 行 。 只 需要 在 每 行 末尾 都 加 上 引号 ， 
同时 对 于 除 第 一 行 外 的 其 他 各 行 ， 都 在 行 首 加 上 引号 并 缩 进 。 这样 ，Python 将 自动 合并 圆 括号 内 
的 所 有 字符 串 。 为 打印 配料 ， 编 写 一 个 for 循环 ( 见 @ )。 为 访问 配料 列表 ， 使 用 键 'toppings'， 
这 样 Python 将 从 字典 中 提取 配料 列表 。 


下 面 的 输出 概述 了 要 制作 的 比萨 : 


You ordered a thick-crust pizza with the following toppings: 
mushrooms 
extra cheese 


每 当 需 要 在 字典 中 将 一 个 键 关联 到 多 个 值 时 , 都 可 以 在 字典 中 嵌 套 一 个 列表 。 在 本 章 前 面 有 
关 喜 欢 的 编程 语言 的 示例 中 , 如 果 将 每 个 人 的 回答 都 存储 在 一 个 列表 中 , 被 调查 者 就 可 选择 多 种 
喜欢 的 语言 。 在 这 种 情况 下 ， 当 我 们 遍历 字典 时 ， 与 每 个 被 调查 者 相关 联 的 都 是 一 个 语言 列表 ， 
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使 用 一 个 for 循环 来 遍历 与 被 


而 不 是 一 种 语言 ; 因此 ， 在 裔 历 该 字典 的 for 循环 中 ， 我 们 需要 
调查 者 相关 联 的 语言 列表 : 


favorie” @ favorite languages = { 

'jen': ['python', 'ruby'], 
“sarahe :| €.,)]; 

'edward': ['ruby', 'go'], 
'phil': ['python', 'haskell'], 


languages.py 


@ for name, languages in favorite languages.items() 
print(f"\n{name.title()}'s favorite languages are:") 


@ for language in languages: 
print(f"\t{language.title()}") 

如 你 所 见 ， 现 在 与 每 个 名 字 相 关联 的 值 都 是 一 个 列表 ( 见 @ )。 请 注意 ， 有些 人 喜欢 的 语言 
只 有 一 种 ， 而 有 些 人 有 多 种 。 人 遍历 字典 时 ( 见 @ )， 使 用 变量 languages 来 依次 存储 对 字典 中 每 个 值 
的 引用 ， 因 为 我 们 知道 这 些 值 都 是 列表 。 在 遍历 字典 的 主 循环 中 ， 使 用 了 另 一 个 for 循环 ( 见 @ ) 
列表 。 现 在 ， 每 个 人 想 列 出 多 少 种 喜欢 的 语言 都 可 以 : 


天 


来 遍历 每 个 人 喜欢 的 语言 


Jen's favorite languages are: 
Python 
Ruby 


Sarah's favorite languages are: 
CE 


Edward's favorite languages are: 
Ruby 
Go 
Phil's favorite languages are: 
Python 
Haskell 
为 进一步 改进 这 个 程序 , 可 在 遍历 字典 的 for 循环 开头 添加 一 条 if 语句, 通过 查看 len(languages) 
的 值 来 确定 当前 的 被 调查 者 喜欢 的 语言 是 否 有 多 种 。 如 果 他 喜欢 的 语言 有 多 种 ,就 像 以 前 一 样 显 
示 输 出 ; 如 果 只 有 一 种 ， 就 相应 修改 输出 的 措辞 ， 如 显示 Sarah's favorite language is C。 


列表 和 字典 的 谈 套 层级 不 应 太 多 。 如 果 广 套 层 级 比 前 面 的 示例 多 得 多 ,很 可 能 有 更 简单 


吕 


注 
的 解决 方案 。 


6.4.3 在 字典 中 存储 字典 
可 在 字典 中 纶 套 字 典 ， 但 这 样 做 时 ， 代 码 可 能 很 快 复杂 起 来 。 例 如 ， 如 果 有 多 个 网 站 用 户 ， 
每 个 都 有 独特 的 用 户 名 , 可 在 字典 中 将 用 户 名 作为 键 ,然后 将 每 位 用 户 的 信息 存储 在 一 个 字典 中 ， 
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并 将 该 字典 作为 与 用 户 名 相关 联 的 值 。 在 下 面 的 程序 中 , 存储 了 每 位 用 户 的 三 项 信息 : 名 、 姓 和 
居住 地 。 为 访问 这 些 信息 ,我 们 遍历 所 有 的 用 户 名 ， 并 访问 与 每 个 用 户 名 相关 联 的 信息 字典 : 


many_Users.py USEeIS = { 
'aeinstein': { 
‘first': 'albert', 
"last': 'einstein', 
'location': 'princeton’', 


外 


'mcurie': { 
'first': 'marie', 
"last': 'curie', 
'location': 'paris', 


外 


} 


@ for username, user info in users.items(): 

@ print(f"\nUsername: {username}") 

(3 full name = f"{user info['first']} {user info['last']}" 
location = user info['location'] 


@ print(f"\tFull name: {full name.title()}") 
print(f"\tLocation: {location.title()}") 


首先 定义 一 个 名 为 users 的 字典 ， 其 中 包含 两 个 键 : 用 户 名 'aeinstein' 和 'mcurie'。 与 每 个 
键 相 关联 的 值 都 是 一 个 字典 ， 其 中 包含 用 户 的 名 、 姓 和 居住 地 。 在 @ 人 处 ,遍历 字典 users， 让 
Python 依次 将 每 个 键 赋 给 变量 username， 并 依次 将 与 当前 键 相关 联 的 字典 赋 给 变量 user info。 
在 循环 内 部 的 @@ 处 ， 将 用 户 名 打印 出 来 。 

在 @ 处 ， 开 始 访问 内 部 的 字典 。 变 量 user info 包含 用 户 信息 字 典 ， 而 该 字典 包含 三 个 键 : 
'first' 、'last' 和 'location'。 对 于 每 位 用 户 ， 都 使 用 这 些 刍 来 生成 整洁 的 姓名 和 居住 地 ， 然 后 
打印 有 关 用 户 的 简要 信息 ( 见 @ ): 


Username: aeinstein 
Full name: Albert Einstein 
Location: Princeton 


Username: mcurie 
Full name: Marie Curie 
Location: Paris 


注意 ， 表 示 每 位 用 户 的 字典 都 具有 相同 的 结构 。 虽 然 Python 并 没有 这 样 的 要 求 ， 但 这 使 
的 字典 处 理 起 来 更 容易 。 倘 若 表示 每 位 用 户 的 字典 都 包含 不 同 的 键 ，for 循环 内 部 的 代码 


动手 试 一 试 
练习 6-7: 人 们 在 为 完成 练习 6-1 而 编写 的 程序 中 ， 再 创建 两 个 表示 人 的 字典 ， 
然后 将 这 三 个 字典 都 存储 在 一 个 名 为 people 的 列表 中 。 遍 历 这 个 列表 ， 将 其 中 每 个 人 
的 所 有 信息 都 打印 出 来 。 
练习 6-8: 宠物 创建 多 个 表示 宠物 的 字典 ， 每 个 字典 都 包含 宠物 的 类 型 及 其 主人 
的 名 字 。 将 这 些 字 典 存储 在 一 个 名 为 pets 的 列表 中 ， 再 遍历 该 列表 ， 并 将 有 关 每 个 完 
物 的 所 有 信息 都 打印 出 来 。 


练习 6-9: 喜欢 的 地 方 ” 创 建 一 个 名 为 favorite places 的 字典 。 在 这 个 字典 中 ， 
将 三 个 人 的 名 字 用 作 键 , 并 存储 每 个 人 喜欢 的 1 ~3 个 地 方 。 为 了 让 这 个 练习 更 有 趣 些 ， 


可 以 让 一 些 朋 友 说 出 他 们 喜欢 的 几 个 地 方 。 遍历 这 个 字典 ,并 将 其 中 每 个 人 的 名 字 及 其 
喜欢 的 地 方 打 印 出 来 。 

练习 6-10: 喜欢 的 数 2 修改 为 完成 练习 6-2 而 编写 的 程序 ， 让 每 个 人 都 可 以 有 多 
个 喜欢 的 数 ， 然 后 将 每 个 人 的 名 字 及 其 喜欢 的 数 打印 出 来 。 

练习 6-11: 城市 ”创建 一 个 名 为 cities 的 字典 ， 将 三 个 城市 名 用 作 键 。 对 于 每 座 
城市 ， 都 创建 一 个 字典 ， 并 在 其 中 包含 该 城市 所 属 的 国家 、 人 口 约 数 以 及 一 个 有 关 该 城 
市 的 事实 。 在 表示 每 座 城市 的 字典 中 ， 应 包含 country、population 和 fact 等 键 。 将 每 
座 城市 的 名 字 以 及 有 关 信 息 都 打印 出 来 。 

练习 6-12: 扩展 ”本章 的 示例 足够 复杂 ， 能 以 很 多 方式 进行 扩展 。 请 对 本 章 的 一 
个 示例 进行 扩展 : 添加 键 和 值 、 调 整 程序 要 解决 的 问题 或 改进 输出 的 格式 。 


6.5 ”小结 


在 本 章 中 , 你 学 习 了 : 如 何 定义 字典 ,以 及 如 何 使 用 存储 在 字典 中 的 信息 ; 如 何 访问 和 修改 
字典 中 的 元 素 , 以 及 如 何人 遍历 字典 中 的 所 有 信息 ; 如 何 遍 历 字典 中 所 有 的 键 值 对 、 所 有 的 键 和 所 
有 的 值 ; 如 何在 列表 中 纵 套 字典 、 在 字典 中 藤 套 列表 以 及 在 字典 中 舱 套 字典 。 


在 下 一 章 中 ， 你 将 学 习 while 循环 以 及 如 何 从 用 户 那 里 获取 输入 。 这 是 激动 人 心 的 一 章 ,， 让 
你 知道 如 何 将 程序 变 成 交互 性 的 : 能 够 对 用 户 输入 做 出 响应 。 


用 户 输 入 和 while 循环 


大 多 数 程序 旨 在 解决 最 终 用 户 的 问题 ,为 此 通常 需要 从 用 户 那 里 
获取 一 些 信息 。 例 如 , 假设 有 人 要 判断 自己 是 否 到 了 投票 年 龄 。 要 编 
写 回 答 这 个 问题 的 程序 ,就 需要 知道 用 户 的 年 龄 ,才能 给 出 答案 。 因 
此 ， 这 种 程序 需要 让 用 户 和 输入 年 龄 ， 再 将 其 与 投票 年 龄 进行 比较 ， 以 
判断 用 户 是 否 到 了 投票 年 龄 ， 从 而 给 出 结果 。 

在 本 章 中 ,你 将 学 习 如 何 接受 用 户 输 入 ,以 便 程 序 进行 处 理 。 程 
序 需要 一 个 名 字 时 ， 你 需要 提示 用 户 输 入 该 名 字 ; 程序 需要 一 个 名 音 
时 ， 你 需要 提示 用 户 输入 一 系列 名 字 。 为 此 ， 你 将 使 用 函数 input()。 

你 还 将 学 习 如 何 让 程序 不 断 地 运行 ,以 便 用 户 根 据 需 要 输入 信息 ， 并 在 程序 中 使 用 这 些 
信息 。 为 此 ， 你 将 使 用 while 循环 让 程序 不 断 运行 ， 直 到 指定 的 条 件 不 满足 为 止 。 


通过 获取 用 户 输入 并 学 会 控制 程序 的 运行 时 间 ， 你 就 能 编写 出 交互 式 程序 。 


沁 
< 


7.1 函数 input() 的 工作 原理 a 


函数 input() 让 程序 暂停 运行 ， 等 待 用 户 输入 一 些 文本 。 获 取 用 户 输入 后 ，Python 将 其 赋 给 
一 个 变量 ， 以 方便 你 使 用 。 


例如 ， 下 面 的 程序 让 用 户 输入 一 些 文本 ， 再 将 这 些 文本 呈现 给 用 户 : 


parrotipy _ message = input("Tell me something, and I will repeat it back to you: ") 
print(message) 


函数 input() 接 受 一 个 参数 一 一 要 向 用 户 显 示 的 提示 prompt ) 或 说 明 ， 让 用 户 知道 该 如 何 
做 。 在 本 例 中 ，Python 运行 第 一 行 代码 时 ,用 户 将 看 到 提示 Tell me something, and I will repeat 
it back to you:。 程 序 等 竺 用 户 输入 ， 并 在 用 户 按 回 车 键 后 继续 运行 。 输 入 被 赋 给 变量 message， 
接 下 来 的 print(message) 将 输入 呈现 给 用 户 : 
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Tell me something, and I will repeat it back to you: Hello everyone! 
Hello everyone! 


注意 Sublime Text 等 众多 编辑 器 不 能 运行 提示 用 户 输 入 的 程序 。 你 可 以 使 用 Sublime Text 来 编 
写 提示 用 户 输入 的 程序 ， 但 必须 从 终端 运行 它们 。 详 情 请 参阅 1.5 节 。 
7.1.1 编写 清晰 的 程序 


每 当 使 用 函数 input() 时 ， 都 应 指定 清晰 易 懂 的 提示 ， 准 确 地 指出 希望 用 户 提供 什么 样 的 信 
息 旨 出 用 户 应 该 输入 何 种 信息 的 任何 提示 都 行 ， 如 下 所 示 : 


greelerpy name = input("Please enter your name: ") 
print(f"\nHello, {name}!") 


通过 在 提示 末尾 ( 这 里 是 冒号 后 面 ) 包含 一 个 空格 ,可 将 提示 与 用 户 输 入 分 开 ，, 让 用 户 清楚 
地 知道 其 输入 始 于 何 处 ， 如 下 所 示 : 


Please enter your name: Eric 
Hello, Eric! 


有 时 候 ， 提 示 可 能 超过 一 行 。 例 如 ， 你 可 能 需要 指出 获取 特定 输入 的 原因 。 在 这 种 情况 下 ， 
可 将 提示 赋 给 一 个 变量 ,再 将 该 变量 传递 给 函数 input()。 这 样 ， 即 便 提示 超过 一 行 ，input() 语 
句 也 会 非常 清晰 。 


greeterpy prompt = "If you tell us who you are, we can personalize the messages you See.” 
prompt += "\nWhat is your first name? " 


name = input(prompt) 
print(f"\nHello, {name}!") 


本 例 演示 了 一 种 创建 多 行 字符 串 的 方式 。 第 一 行将 消息 的 前 半 部 分 赋 给 变量 prompt 中 。 在 
第 二 行 中 ， 运 算 符 += 在 前 面 赋 给 变量 prompt 的 字符 串 末尾 附加 一 个 字符 串 。 


最 终 的 提示 占据 两 行 ， 且 问号 后 面 有 一 个 空格 ,这 也 是 为 了 使 其 更 加 清晰 : 


If you tell us who you are, we can personalize the messages you see. 
What is your first name? Eric 


Hello, Eric! 


7.1.2 ”使 用 int() 来 获取 数值 输入 
使 用 函数 input() 时 , Python 将 用 户 输入 解读 为 字符 串 。 请 看 下 面 让 用 户 输入 年 龄 的 解释 器 会 话 ; 
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>>> age = input("How old are you? ") 
How old are you? 21 

>>> age 

i 


用 户 输入 的 是 数 21， 但 我 们 请 求 Python 提供 变量 age 的 值 时 ， 它 返回 的 是 '21' 一 一 用 户 输 
入 数值 的 字符 串 表 示 。 我 们 怎么 知道 Python 将 输入 解读 成 了 字符 串 呢 ? 因为 这 个 数 用 引号 括 起 
了 。 如 果 只 想 打印 输入 ， 这 一 点 问题 都 没有 ; 但 如 果 试 图 将 输入 作为 数 来 使 用 ， 就 会 引发 错误 : 


>>> age = input("How old are you? ") 
How old are you? 21 
@ >>> age >= 18 
Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
@ TypeError: unorderable types: str() >= int() 


试图 将 输入 用 于 数值 比较 时 ( 见 @ )，Python 会 引发 错误 ， 因 为 它 无 法 将 字符 串 和 整数 进行 
比较 : 不 能 将 赋 给 age 的 字符 串 '21' 与 数值 18 进行 比较 ( 见 @ )。 

为 解决 这 个 问题 ， 可 使 用 函数 int()， 它 让 Python 将 输入 视 为 数值 。 函 数 int() 将 数 的 字符 
串 表示 转换 为 数值 表示 ， 如 下 所 示 : 


>>> age = input("How old are you? ") 
How old are you? 21 
@ >>> age = int(age) 
>>> age >= 18 
True 


在 本 例 中 , 用 户 根据 提示 输入 21 后 , Python 将 这 个 数 解读 为 字符 串 , 但 随后 int() 将 这 个 字 
符 串 转换 成 了 数值 表示 ( 见 @ )。 这 样 Python 就 能 运行 条 件 测试 了 : 将 变量 age ( 它 现 在 表示 的 
是 数值 21 ) 同 18 进行 比较 ， 看 它 是 否 大 于 或 等 于 18。 测 试 结果 为 True。 


如 何在 实际 程序 中 使 用 函数 int() 呢 ? 请 看 下 面 的 程序 ， 它 判断 一 个 人 是 否 满足 坐 过 山 车 的 
身高 要 求 : 


rollercoaster.py height = input("How tall are you, in inches? ") 
height = int(height) 


if height >= 48: 
print("\nYou're tall enough to ride!") 
else: 
print("\nYou'll be able to ride when you're a little older.") 


在 此 程序 中 ， 为 何 可 以 将 neight 同 48 进行 比较 呢 ? 因为 在 比较 前 ，height = int(height) 
将 输入 转换 成 了 数值 表示 。 如 果 输 入 的 数 大 于 或 等 于 48， 就 指出 用 户 满足 身高 条 件 : 
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How tall are you, in inches? 71 


You're tall enough to Tidel 


将 数值 输入 用 于 计算 和 比较 前 ， 务 必 将 其 转换 为 数值 表示 。 
7.1.3 求 模 运算 符 
处 理 数值 信息 时 ， 求 模 运算 符 (%) 是 个 很 有 用 的 工具 ， 它 将 两 个 数 相 除 并 返回 余数 : 


>>> 4%3 
1 
>>> 5%3 
2 
>>> 6%3 
0 
>>>7%3 
1 


求 模 运算 符 不 会 指出 一 个 数 是 男 一 个 数 的 多 少 倍 ， 只 指出 余数 是 多 少 。 


如 果 一 个 数 可 被 男 一 个 数 整 除 ， 余 数 就 为 0， 因 此 求 模 运算 将 返回 0。 可 利用 这 一 点 来 判断 
个 数 是 奇数 还 是 偶数 : 


even_ or odd.py number = input("Enter a number, and I 11 tell you if it's even or odd: ") 
number = int(number) 


if number % 2 == 0: 
print(f"\nThe number {number} is even.") 
else: 
print(f"\nThe number {number} is odd.") 


偶数 都 能 被 2 整除 ， 因 此 如 果 对 一 个 数 和 2 执行 求 模 运算 的 结果 为 0， 即 number % 2 
那么 这 个 数 就 是 偶数 ; 否则 就 是 奇数 。 


Enter a number, and I'l1] tell you if it's even or odd: 42 


The number 42 is even. 


动手 试 一 试 
练习 7-1: 汽车 租赁 编写 一 个 程序 ， 询 问 用 户 要 租赁 什么 样 的 汽车 ， 并 打印 一 条 


消息 心 > ， 下 面 受 一 个 例子 。 


Let me see ifI can find you a Subaru. 
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练习 7-2: 餐馆 订 位 编写 一 个 程序 ， 询问 用 户 有 多 少 人 用 餐 。 如 果 超 过 8 位 ， 就 
打印 一 条 消息 ， 指 出 没有 空 桌 ; 否则 指出 有 空 桌 。 
练习 7-3: 10 的 整数 倍 ”让 用 户 输入 一 个 数 ， 并 指出 该 数 是 否 是 10 的 整数 倍 。 


7.2 ”while 循环 简介 


for 循环 用 于 针对 集合 中 的 每 个 元 素 都 执行 一 个 代码 块 ， 而 while 循环 则 不 断 运行 ， 直 到 指 
定 的 条 件 不 满足 为 止 。 


7.2.1 使 用 while 循环 
可 使 用 while 循环 来 数 数 。 例 如 ， 下 面 的 while 循环 从 1 数 到 5: 


counting.py CUrren t_number = 1 
while current number <= 5: 
print(current number) 
current number += 1 


在 第 一 行 , 将 1 赋 给 变量 current_number,， 从 而 指定 从 1 开始 数 。 将 接 下 来 的 while 循环 设置 
成 : 只 要 current_number 小 于 或 等 于 5, 就 接着 运行 这 个 循环 。 循环 中 的 代码 打印 current_number 
的 值 ， 再 使 用 代码 current_number += 1 (代码 current_number = current_number + 1 的 简写 ) 
将 其 值 加 1。 

只 要 满足 条 件 current_number <= 5, Python 就 接着 运行 这 个 循环 ,因为 1 小 于 5, 所 以 Python 
打印 1 并 将 current_number 加 1, 使 其 为 2; 因 为 2 小 于 5, 所 以 Python 打印 2 并 将 current_number 
加 1， 使 其 为 3; 依 此 类 推 。 一 旦 current_number 大 于 5， 循环 就 将 停止 ， 整 个 程序 也 将 结束 : 


MODODOP 


你 每 天 使 用 的 程序 很 可 能 就 包含 while 循环 。 例 如 ， 游 戏 使 用 while 循环 ， 确 保 在 玩家 想 玩 
时 不 断 运 行 , 并 在 玩家 想 退 出 时 停止 运行 。 如 果 程 序 在 用 户 没 有 让 它 停止 时 停止 运行 , 或 者 在 用 
户 要 退出 时 还 继续 运行 ， 那 就 太 没有 意思 了 。 因 此 ，while 循环 很 有 用 。 


7.2.2 ”让 用 户 选 择 何 时 退出 


可 以 使 用 while 循环 让 程序 在 用 户 愿 意 时 不 断 运 行 , 如 下 面 的 程序 parrot.py 所 示 。 我 们 在 其 
中 定义 了 一 个 退出 值 ， 只 要 用 户 输入 的 不 是 这 个 值 ， 程 序 就 将 接着 运行 : 
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parrotpy @ prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter 'quit' to end the program. " 
@ message = "" 
四 while message != 'quit': 
message = input(prompt) 
print(message) 


@ 处 定义 了 一 条 提示 消息 ,告诉 用 户 有 两 个 选择 : 要 么 输入 一 条 消息 ,要么 输入 退出 值 (这 
里 为 'quit' )。 接 下 来 , 创建 变量 message ( 见 @ )， 用 于 记录 用 户 输入 的 值 。 我 们 将 变量 message 
的 初始 值 设 置 为 空 字符 串 "", 让 Python 首次 执行 while 代码 行 时 有 可 供 检查 的 东西 。 Python 首次 
执行 while 语句 时 ， 需 要 将 message 的 值 与 'quit' 进 行 比较 , 但 此 时 用 户 还 没有 输入 。 如 果 没 有 


可 供 比 较 的 东西 ，Python 将 无 法 继续 运行 程序 。 为 解决 这 个 问题 ， 必 


须 给 变量 message 指定 初始 


值 。 虽然 这 个 初始 值 只 是 一 个 空 字符 串 , 但 符合 要 求 , 能 够 让 Python 执行 while 循环 所 需 的 比较 。 


只 要 message 的 值 不 是 'quit' ， 这 个 循环 ( 见 @ ) 就 会 不 断 运行 。 


首次 遇 到 这 个 循环 时 ，message 是 一 个 空 字 符 串 ， 因 此 Python 进入 该 循环 。 执 行 到 代码 行 
message = input(prompt) 时 ，Python 显示 提示 消息 ， 并 等 待 用 户 输入 。 不 管用 户 输入 是 什么 ， 都 
将 赋 给 变量 message 并 打印 出 来 。 接 下 来 ，Python 重新 检查 while 语句 中 的 条 件 。 只 要 用 户 输入 


的 不 是 单词 'quit', Python 就 会 再 次 显示 提示 消息 并 等 待 用 户 输入 。 等 到 用 户 终于 输入 'quit' 后 ， 


Python 停止 执行 while 循环 ， 整 个 程序 也 到 此 结束 : 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello again. 
Hello again. 


Tell me something, and I will repeat it back to you: 
nter 'quit' to end the program. quit 


这 个 程序 很 好 ,唯一 美中不足 的 是 , 它 将 单词 'quit' 也 作为 一 条 消 , 
需 


种 问题 ， 只 需 使 用 一 个 简单 的 if 测试 : 


息 打 印 了 出 来 。 为 修复 这 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter 'quit' to end the program. " 


message = "" 
while message != ' quit ' : 
message = input(prompt) 


if message != ' quit ' : 
print(message) 
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现在 ， 程 序 在 显示 消息 前 将 做 简单 的 检查 ， 仅 在 消息 不 是 退出 值 时 才 打印 它 : 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello again. 
Hello again. 


Tell me something, and I will repeat it back to you: 
ter 'quit' to end the program. quit 


mm 
学 


7.2.3 ”使 用 标志 


在 前 一 个 示例 中 , 我 们 让 程序 在 满足 指定 条 件 时 执行 特定 的 任务 。 但 在 更 复杂 的 程序 中 , 很 
多 不 同 的 事件 会 导致 程序 停止 运行 。 在 这 种 情况 下 ， 该 怎么 办 呢 ? 


例如 ,有 多 种 事件 可 能 导致 游戏 结束 ， 如 玩家 失去 所 有 飞船 、 时 间 已 用 完 , 或 者 要 保护 的 城 
市 被 全 部 摧毁 。 导 致 程序 结束 的 事件 有 很 多 时 ， 如 果 在 一 条 while 语句 中 检查 所 有 这 些 条 件 ,将 
既 复 杂 又 困难 。 


在 要 求 很 多 条 件 都 满足 才 继续 运行 的 程序 中 , 可 定义 一 个 变量 , 用 于 判断 整个 程序 是 否 处 于 
活动 状态 。 这 个 变量 称 为 标志 (flag )， 充 当 程序 的 交通 信号 灯 。 可 以 让 程序 在 标志 为 True 时 继 
续 运 行 ， 并 在 任何 事件 导致 标志 的 值 为 False 时 让 程序 停止 运行 。 这 样 ， 在 while 语句 中 就 只 需 
检查 一 个 条 件 : 标志 的 当前 值 是 否 为 True。 然 后 将 所 有 其 他 测试 ( 是 否 发 生 了 应 将 标志 设置 为 
False 的 事件 ) 都 放 在 其 他 地 方 ， 从 而 让 程序 更 整洁 。 


下 面 在 前 一 节 的 程序 parrot.py 中 添加 一 个 标志 。 将 其 命名 为 active (你 可 给 它 指定 任何 名 
称 )， 用 于 判断 程序 是 否 应 继续 运行 : 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter 'quit' to end the program. " 


@ active = True 
@ while active: 
message = input(prompt) 


8 if message == "quit': 
active = False 
0 else: 
print(message) 


将 变量 active 设置 为 True ( 见 @ )， 让 程序 最 初 处 于 活动 状态 。 这 样 做 简化 了 while 语句 ， 
因为 不 需要 在 其 中 做 任何 比较 一 一 相关 的 逻辑 由 程序 的 其 他 部 分 处 理 。 只 要 变量 active 为 True， 
循环 就 将 继续 运行 ( 见 @ )。 
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在 while 循环 中 , 在 用 户 输入 后 使 用 一 条 if 语句 来 检查 变量 message 的 值 。 如 果 用 户 输入 的 


是 'quit' ( 见 @ ), 就 将 变量 active 设置 为 False。 这 将 导致 while 循环 不 再 继续 执行 。 如 果 用 户 


输入 的 不 是 'quit'〈 见 @ )， 就 将 输入 作为 一 条 消息 打印 出 来 。 


这 个 程序 的 输出 与 前 一 个 示例 相同 。 前 一 个 示例 将 条 件 测试 直接 放 在 了 while 语句 中 ， 而 这 
个 程序 则 使 用 一 个 标志 来 指出 程序 是 否 处 于 活动 状态 。 这 样 ， 如 果 要 添加 测试 (如 elif 语句 ) 
以 检查 是 否 发 生 了 其 他 导致 active 变 为 False 的 事件 ， 就 会 很 容易 。 在 复杂 的 程序 ( 如 很 多 事 
件 会 导致 程序 停止 运行 的 游戏 ) 中 ,标志 很 有 用 : 在 任意 一 个 事件 导致 活动 标志 变 成 False 时 ， 
主 游戏 循环 将 退出 ， 此 时 可 显示 一 条 游戏 结束 消息 ， 并 让 用 户 选 择 是 否 要 重新 玩 。 


7.2.4 使 用 break 退出 循环 


要 立即 退出 while 循环 ,不 再 运行 循环 中 余下 的 代码 ， 也 不 管 条 件 测试 的 结果 如 何 ， 可 使 用 
break 语句 。break 语句 用 于 控制 程序 流程 ， 可 用 来 控制 哪些 代码 行将 执行 、 哪 些 代码 行 不 执行 ， 


从 而 让 程序 按 你 的 要 求 执行 你 要 执行 的 代码 。 


例如 ,来 看 一 个 让 月 


有 户 指 出 他 到 过 哪些 地 方 的 程序 。 在 这 个 程序 中 ,可 在 用 户 输入 'quit' 后 


使 用 break 语句 立即 退出 while 循环 : 


cities.py prompt = "\nPlease enter the name of a city you have visited:" 
prompt += "\n(Enter 'quit' when you are finished.) " 


@ while True: 


city = input(prompt) 

if city == 'quit': 
break 

else: 


print(f"I'd love to go to {city.title()}!") 


以 while True( 见 @ ) 打头 的 循环 将 不 断 运 行 ， 直 到 遇 到 break 语句 。 这 个 程序 中 的 循环 不 
断 让 用 户 输入 他 到 过 的 城市 的 名 字 , 直到 用 户 输入 'quit' 为 止 。 用 户 输入 'quit' 后 , 将 执行 break 
语句 ， 导 致 Python 退出 循环 : 


Please en 


ter the name of a < 


(Enter 'quit' when you are f 


Id love 


Please en 


Id love 


Please en 


to go to New York! 


ter the name of a < 


ter the name of a < 


ity you have visited: 
inished.) New York 


ity you have visited: 
(Enter 'quit' when you are fi 
to go to San Francisco! 


nished.) San Francisco 


ity you have visited: 
(Enter 'quit' when you are fi 


nished.) quit 
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注意 ”在 任何 Python 循环 中 都 可 使 用 break 语句 。 例 如 ， 可 使 用 break 语句 来 退出 遍历 列表 或 
字典 的 for 循环 。 


7.2.5 在 循环 中 使 用 continue 


要 返回 循环 开头 ， 并 根据 条 件 测试 结果 决定 是 否 继续 执行 循环 ， 可 使 用 continue 语句 ， 它 
不 像 break 语句 那样 不 再 执行 余下 的 代码 并 退出 整个 循环 。 例 如 ， 来 看 一 个 从 1 数 到 10 但 只 打 
印 其 中 奇数 的 循环 : 


counting.py Current number = 0 
while current number < 10: 
© current number += 1 
if current number % 2 == 0: 
continue 


print(current number) 


首先 将 current_number 设置 为 0, 由 于 它 小 于 10, Python 进入 while 循环 。 进 入 循环 后 ， 以 
步 长 1 的 方式 往 上 数 ( 见 @ )， 因 此 current_number 为 1。 接 下 来 ，if 语句 检查 current_number 
与 2 的 求 模 运 算 结 果 。 如 果 结 果 为 0 ( 意味 着 current_number 可 被 2 整除 )， 就 执行 continue 语 
句 ， 让 Python 忽略 余下 的 代码 ， 并 返回 循环 的 开头 。 如 果 当 前 的 数 不 能 被 2 整除 ， 就 执行 循环 
中 余下 的 代码 ， 将 这 个 数 打印 出 来 : 


AD ~ nn WwW pp 


7.2.6 ”避免 无 限 循环 


每 个 while 循环 都 必须 有 停止 运行 的 途径 ， 这 样 才 不 会 没完 没 了 地 执行 下 去 。 例 如 ， 下 面 的 
循环 从 1 数 到 5: 


counting.py X= 1 
while x <= 5: 
print(x) 
X += 1 


但 如 果 像 下 面 这 样 不 小 心 遗漏 了 代码 行 x += 1， 这 个 循环 将 没完 没 了 地 运行 : 


# 这 个 循环 将 没完 没 了 地 运行 | 
X = 工 
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while x <= 5: 
print(x) 


在 这 里 ，x 的 初始 值 为 1， 但 根本 不 会 变 。 因 此 条 件 测试 x <= 5 始终 为 True， 导 致 hile 循 
环 没完 没 了 地 打印 1， 如 下 所 示 : 


和 PAP 


-- Ship-- 


每 个 程序 员 都 会 偶尔 因 不 小 心 而 编写 出 无 限 循环 ， 在 循环 的 退出 条 件 比较 微妙 时 尤其 如 此 。 
如 果 程 序 陷 入 无 限 循 环 ， 可 按 Ctrl + C， 也 可 关闭 显示 程序 输出 的 终端 窗口 。 

要 避免 编写 无 限 循环 ,务必 对 每 个 while 循环 进行 测试 ,确保 其 按 预期 那样 结束 。 如 果 你 希 
望 程序 在 用 户 输入 特定 值 时 结束 , 可 运行 程序 并 输入 这 样 的 值 ,如 果 在 这 种 情况 下 程序 没有 结 
请 检查 程序 处 理 这 个 值 的 方式 ,确认 程序 至 少 有 一 个 这 样 的 地 方 能 让 循环 条 件 为 False， 或 者 让 
break 语句 得 以 执行 。 


注意 ”Sublime Text 等 一 些 编辑 器 内 髓 了 输出 窗口 , 这 可 能 导致 难以 结束 无 限 循 环 , 不 得 不 通过 
关闭 编辑 器 来 结束 。 在 这 种 情况 下 ， 可 在 输出 窗口 中 单 击 和 鼠标 ， 再 按 Ctrl+C， 这 样 应 该 
能 够 结束 无 限 循环 。 


动手 试 一 斌 


练习 7-4: 比萨 配料 编写 一 个 循环 ， 提 示 用 户 输入 一 系列 比萨 配料 ， 并 在 用 户 输 
入 'quit' 时 结束 循环 。 每 当 用 户 输入 一 种 配料 后 ， 都 打印 一 条 消息 ， 指 出 我 们 会 在 比萨 
中 添加 这 种 配料 。 

练习 7-5: 电影 票 ”有 家 电影 院 根据 观众 的 年 龄 收取 不 同 的 票 价 : 不 到 3 岁 的 观众 
免费 ; 3~12 岁 的 观众 收费 10 美元 ; 超过 12 岁 的 观众 收费 15 美元 。 请 编写 一 个 循环 ， 


在 其 中 询问 用 户 的 年 龄 ， 并 指出 其 票 价 。 

练习 7-6: 三 种 出 路 以 不 同 的 方式 完成 练习 74 或 练习 7-5， 在 程序 中 采取 如 下 做 法 。 
口 在 while 循环 中 使 用 条 件 测试 来 结束 循环 。 
口 使 用 变量 active 来 控制 循环 结束 的 时 机 。 
口 使 用 break 语句 在 用 户 输 入 'quit' 时 退出 循环 。 

练习 7-7: 无 限 循环 编写 一 个 没完 没 了 的 循环 ， 并 运行 吉 束 该 循环 ， 可 按 
Ctrl1+C， 也 可 关闭 显示 输出 的 窗口 )。 
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7.3 使 用 while 循环 处 理 列表 和 字典 


到 目前 为 止 , 我 们 每 次 都 只 处 理 了 一 项 用 户 信息 : 获取 用 户 的 输入 , 再 将 输入 打印 出 来 或 做 
出 应 答 ; 循环 再 次 运行 时 ， 获 悉 另 一 个 输入 值 并 做 出 响应 。 然 而 ， 要 记录 大 量 的 用 户 和 信息 ， 需 
要 在 while 循环 中 使 用 列表 和 字典 。 

for 循环 是 一 种 遍历 列表 的 有 效 方式 ， 但 不 应 在 for 循环 中 修改 列表 ， 否 则 将 导致 Python 难 
以 跟踪 其 中 的 元 素 。 要 在 遍历 列表 的 同时 对 其 进行 修改 ， 可 使 用 while 循环 。 通 过 将 while 循环 
同 列表 和 字典 结合 起 来 使 用 ， 可 收集 、 存 储 并 组 织 大 量 输入 ， 供 以 后 查看 和 显示 。 


7.3.1 在 列表 之 间 移 动 元 素 

假设 有 一 个 列表 包含 新 注册 但 还 未 验证 的 网 站 用 户 。 验 证 这 些 用 户 后 , 如 何 将 他 们 移 到 另 一 
个 已 验证 用 户 列 表 中 呢 ? 一 种 办 法 是 使 用 一 个 while 循环 , 在 验证 用 户 的 同时 将 其 从 未 验证 用 户 
列表 中 提取 出 来 ， 青 将 其 加 入 另 一 个 已 验证 用 户 列表 中 。 代 码 可 能 类 似 于 下 面 这 样 : 


confirmed。 # 首先 ， 创 建 一 个 待 验证 用 户 列表 
users.py # 和 一 个 用 于 存储 已 验证 用 户 的 空 列表 。 
@ unconfirmed users = ['alice', 'brian', "candace '] 
confirmed users = [] 


# 验证 每 个 用 户 ， 直 到 没有 未 验证 用 户 为 止 。 

# ”将 每 个 经 过 验证 的 用 户 都 移 到 已 验证 用 户 列表 中 。 
@ while unconfirmed users: 
3 current user = unconfirmed users.pop() 


print(f"Verifying user: {current user.title()}") 
4 confirmed users.append(current user) 


# 显示 所 有 已 验证 的 用 户 。 

print("\nThe following users have been confirmed:") 

for confirmed user in confirmed users: 
print(confirmed user.title()) 


首先 创建 一 个 未 验证 用 户 列表 ( 见 @ )， 其 中 包含 用 户 Alice 、Brian 和 Candace， 还 创建 了 一 
个 空 列表 , 用 于 存储 已 验证 的 用 户 。@ 处 的 while 循环 将 不 断 运 行 , 直到 列表 unconfirmed_users 
变 成 空 的 。 在 此 循环 中 , @ 处 的 方法 pop() 以 每 次 一 个 的 方式 从 列表 unconfirmed_users 末尾 删除 
未 验证 的 用 户 。 由 于 Candace 位 于 列表 unconfirmed users 末尾 ， 其 名 字 将 首先 被 删除 、 赋 给 变 
量 current_user 并 加 入 列表 confirmed users 中 ( 见 @ )。 接 下 来 是 Brian， 然 后 是 Alice。 


为 模拟 用 户 验证 过 程 , 我 们 打印 一 条 验证 消息 并 将 用 户 加 入 已 验证 用 户 列表 中 。 未 验证 用 户 
列表 越 来 越 短 ， 而 已 验证 用 户 列表 越 来 越 长 。 未 验证 用 户 列表 为 空 后 结束 循环 ， 再 打印 已 验证 用 
户 列表 : 
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Verifying user: Candace 
Verifying user: Brian 
Verifying user: Alice 


The following users have been confirmed: 
Candace 

Brian 

Alice 


7.3.2 ”删除 为 特定 值 的 所 有 列表 元 素 


在 第 3 章 中 , 我 们 使 用 函数 remove() 来 删除 列表 中 的 特定 值 。 这 之 所 以 可 行 , 是 因为 要 删除 
的 值 只 在 列表 中 出 现 一 次 。 如 果 要 删除 列表 中 所 有 为 特定 值 的 元 素 ， 该 怎么 办 呢 ? 

假设 你 有 一 个 宠物 列表 ， 其 中 包含 多 个 值 为 'cat ' 的 元 素 。 要 删除 所 有 这 些 元 素 ， 可 不 断 运 
行 一 个 while 循环 ,直到 列表 中 不 再 包含 值 'cat'， 如 下 所 示 : 


pets.py pets = [ "dog'， 'cat', 'dog', 'goldfish', 'cat', 'rabbit', 'cat'] 
print(pets) 


while 'cat' in pets: 
pets.remove('cat') 


print(pets) 


首先 创建 一 个 列表 ， 其 中 包含 多 个 值 为 'cat' 的 元 素 。 打 印 这 个 列表 后 ，Python 进入 while 
循环 ， 因 为 它 发 现 'cat ' 在 列表 中 至 少 出 现 了 一 次 。 进 入 该 循环 后 ，Python 删除 第 一 个 'cat' 并 返 
回 到 while 代码 行 ， 然 后 发 现 'cat ' 还 包含 在 列表 中 ， 因 此 再 次 进入 循环 。 它 不 断 删 除 'cat' ， 直 
到 这 个 值 不 再 包含 在 列表 中 ， 然 后 退出 循环 并 再 次 打印 列表 : 


['dog', 'cat', 'dog', 'goldfish', 'cat', 'rabbit', 'cat'] 
['dog', 'dog', 'goldfish', 'rabbit'] 


7.3.3 ”使 用 用 户 输入 来 填充 字典 

可 使 用 while 循环 提示 用 户 输入 任意 多 的 信息 。 下 面 创 建 一 个 调查 程序 ， 其 中 的 循环 每 次 执 
行 时 都 提示 输入 被 调查 者 的 名 字 和 回答 。 我 们 将 收集 的 数据 存储 在 一 个 字典 中 , 以 便 将 回答 同 被 
调查 者 关联 起 来 : 


mouniain responses = {} 


poll.py 
# 设置 一 个 标志 ， 指 出 调查 是 否 继 续 。 
polling active = True 


while polling active: 
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# 提示 输入 被 调查 者 的 名 字 和 回答 。 
@ name = input("\nWhat is your name? ") 
Tesponse = input("Which mountain would you like to climb someday? ") 


# 将 回答 存储 在 字典 中 。 
@ responses[name] = response 


# 看 看 是 否 还 有 人 要 参与 调查 。 
© repeat = input("Would you like to let another person respond? (yes/ no) ") 
if repeat == “no': 
polling active = False 


# 调查 结束 ， 显 示 结果 。 
print("\n--- Poll Results ---") 
@ for name, response in responses.items(): 
print(f"{name} would like to climb {response}.") 


这 个 程序 首先 定义 了 一 个 空 字典 ( responses )， 并 设置 了 一 个 标志 ( polling_active ) 用 于 
指出 调查 是 否 继续 。 只 要 polling active 为 True，Python 就 运行 while 循环 中 的 代码 。 

在 这 个 循环 中 ， 提 示 用 户 输入 其 名 字 及 其 喜欢 爬 哪 座 山 ( 见 @ )。 将 这 些 信 息 存 储 在 字典 
responses 中 ( 见 @ )， 然 后 询问 用 户 是 否 继续 调查 ( 见 @ )。 如 果 用 户 输入 yes ,程序 将 再 次 进入 
while 循环 ; 如 果 用 户 输入 no， 标 志 polling active 将 被 设置 为 False， 而 while 循环 将 就 此 结 
束 。 最 后 一 个 代码 块 ( 见 @ ) 显示 调查 结果 。 


如 果 运 行 这 个 程序 ， 并 输入 一 些 名 字 和 回答 ， 输 出 将 类 似 于 下 面 这 样 : 


hat is your name? Eric 
hich mountain would you like to climb someday? Denali 
ould you like to let another person respond? (yes/ no) yes 


hat is your name? Lynn 
hich mountain would you like to climb someday? Devil's Thumb 
ould you like to let another person respond? (yes/ no) no 


--- Poll Results --- 
Eric would like to climb Denali. 
Lynn would like to climb Devil's Thumb. 


动手 试 一 试 
练习 7-8: 熟食 店 创建 一 个 名 为 sandwich orders 的 列表 ， 在 其 中 包含 各 种 三 明 


治 的 名 字 , 再 创建 一 个 名 为 finished sandwiches 的 空 列表 。 遍 历 列表 sandwich orders， 
对 于 其 中 的 每 种 三 明治 ， 都 打印 一 条 消息 ， 如 Imade your tuna sandwich， 并 将 其 移 到 
列表 finished sandwiches 中 。 所 有 三 明治 都 制作 好 后 ， 打 印 一 条 消息 ， 将 这 些 三 明治 
列 出 来 。 
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练习 7-9: 五 香烟 重 牛 肉 卖 完了 使 用 为 完成 练习 7-8 而 创建 的 列表 sandwich orders， 
并 确保 "pastrami' 在 其 中 至 少 出 现 了 三 次 。 在 程序 开头 附近 添加 这 样 的 代码 : 打印 一 条 
消息 ， 指 出 熟食 店 的 五 香烟 惠 牛 肉 ( pastrami ) 卖 完了 ; 再 使 用 一 个 while 循环 将 列表 
sandwich orders 中 的 'pastrami' 都 删除 。 确 认 最 终 的 列表 finished sandwiches 未 包含 
'pastrami', 

练习 7-10: 梦想 的 度假 胜地 编写 一 个 程序 ， 调查 用 户 梦 想 的 度假 胜地 。 使 用 类 
似 于 下 面 的 提示 ， 并 编写 一 个 打印 调查 结果 的 代码 块 。 


If you could visit one place in the world, where would you go7 


7.4 小结 


在 本 章 中 ， 你 学 习 了 : 如 何在 程序 中 使 用 input() 来 让 用 户 提供 信息 ; 如 何 处 理 文本 和 数 的 
输入 , 以 及 如 何 使 用 while 循环 让 程序 按 用 户 的 要 求 不 断 运行 ; 多 种 控制 while 循环 流程 的 方式 : 
设置 活动 标志 、 使 用 break 语句 以 及 使 用 continue 语句 ; 如 何 使 用 while 循环 在 列表 之 间 移 动 
元 素 ， 以 及 如 何 从 列表 中 删除 所 有 包含 特定 值 的 元 素 ; 如 何 结合 使 用 while 循环 和 字典 。 

在 第 8 章 中 ,你 将 学 习 函 数 。 函 数 让 你 能 够 将 程序 分 成 多 个 很 小 的 部 分 ,每 部 分 都 负责 完成 
一 项 具体 任务 。 你 可 以 根据 需要 调用 同一 个 函数 任意 次 , 还 可 将 函数 存储 在 独立 的 文件 中 。 使 用 
函数 可 让 你 编写 的 代码 效率 更 高 、 更 容易 维护 和 排除 故障 ， 还 可 在 众多 不 同 的 程序 中 重用 。 
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在 本 章 中 ,你 将 学 习 编 写 函 数 。 函数 是 带 名 字 的 代码 块 ， 用 于 完 
成 具体 的 工作 。 要 执行 函数 定义 的 特定 任务 ， 可 调用 该 函数 。 需 要 在 
程序 中 多 次 执行 同一 项 任务 时 , 无 须 反复 编写 完成 该 任务 的 代码 ， 只 
需要 调用 执行 该 任务 的 函数 ， 让 Python 运行 其 中 的 代码 即 可 。 你 将 
发 现 , 通过 使 用 函数 , 程序 编写 、 阅 读 、 测 试 和 修复 起 来 都 更 加 容易 。 


你 还 将 学 习 向 函数 传递 信息 的 方式 ;学习 如 何 编 写 主 要 任务 是 显 
示 信 息 的 函数 ,以 及 旨 在 处 理 数据 并 返回 一 个 或 一 组 值 的 函数 ;最 后 ， 
学 习 如 何 将 函数 存储 在 称 为 模块 的 独立 文件 中 ,让 主 程序 文件 的 组 织 
更 为 有 序 。 


8.1 定义 函数 


下 面 是 一 个 打印 问候 语 的 简单 函数 ， 名 为 greet_user(): 


greelerpy ©@ def greet user(): 
@ "mu 显 示 简 单 的 问候 语 。""" 
(3 print("Hello!") 


@ greet user() 


本 例 演示 了 最 简单 的 函数 结构 。@ 处 的 代码 行使 用 关键 字 def 来 告诉 Python， 你 要 定义 一 个 
函数 。 这 是 函数 定义 ， 向 Python 指出 了 函数 名 ， 还 可 能 在 圆 括号 内 指出 函数 为 完成 任务 需要 什 
么 样 的 信息 。 在 这 里 ， 函 数 名 为 greet_user()， 它 不 需要 任何 信息 就 能 完成 工作 ， 因 此 括号 是 空 
的 (即便 如 此 ， 括 号 也 必 不 可 少 )。 最后， 定义 以 冒号 结尾 。 

紧 跟 在 def greet_user(): 后 面 的 所 有 缩 进行 构成 了 函数 体 。@ 处 的 文本 是 称 为 文档 字符 串 
( docstring ) 的 注释 ， 描 述 了 函数 是 做 什么 的 。 文 档 字符 串 用 三 引号 括 起 ，Python 使 用 它们 来 生 
成 有 关 程 序 中 函数 的 文档 。 
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代码 行 print("Hellol") ( 见 @ ) 是 函数 体内 的 唯一 一 行 代码 ， 因 此 greet_user() 只 做 一 项 
工作 : 打印 Hellol。 

要 使 用 这 个 函数 ， 可 调用 它 。 函 数 调用 让 Python 执行 函数 的 代码 。 要 调用 函数 ， 可 依次 指 
定 函数 名 以 及 用 圆 括 号 括 起 的 必要 信息 ， 如 @ 处 所 示 。 由 于 这 个 函数 不 需要 任何 信息 ， 调 用 它 时 
只 需 输 入 greet_user() 即 可 。 和 预期 一 样 ， 它 打印 Hellol : 


Hello! 


8.1.1 向 函数 传递 信息 


只 需 稍 作 修改 ,就 可 让 函数 greet_user() 不 仅 向 用 户 显示 Hellol , 还 将 用 户 的 名 字 作 为 抬头 。 
为 此 ， 可 在 函数 定义 def greet_user() 的 括号 内 添加 username。 通 过 在 这 里 添加 username， 可 让 
函数 接受 你 给 username 指定 的 任何 值 。 现 在 , 这 个 函数 要 求 你 调用 它 时 给 username 指定 一 个 值 。 
调用 greet_user() 时 ， 可 将 一 个 名 字 传 递 给 它 ， 如 下 所 示 


def greet user(username): 
""" 显 示 简 单 的 问候 语 。""" 
print(f"Hello, {username.title()}!") 


greet user('jesse') 


代码 greet_user('jesse' ) 调 用 函数 greet_user(), 并 向 它 提供 执行 函数 调用 print() 所 需 的 
信息 。 这 个 函数 接受 你 传递 给 它 的 名 字 ， 并 向 这 个 人 发 出 问候 : 


Hello, Jessel! 


同样 ，greet_user('sarah' ) 调 用 函数 greet_user() 并 向 它 传 递 'sarah' ， 从 而 打印 Hello， 
Sarah!。 可 根据 需要 调用 函数 greet_user() 任 意 次 ,调用 时 无 论 传 人 什么 名 字 ， 都 将 生成 相应 的 
输出 。 


8.1.2” 实 参 和 形 参 


前 面 定 义 函 数 greet_user() 时 ， 要 求 给 变量 username 指定 一 个 值 。 调 用 这 个 函数 并 提供 这 
种 信息 (人 名 ) 时 ， 它 将 打印 相应 的 问候 语 。 


在 函数 greet_user() 的 定义 中 ， 变 量 username 是 一 个 形 参 ( parameter )， 即 函数 完成 工作 所 
需 的 信息 。 在 代码 greet_user('jesse') 中 , 值 'jesse' 是 一 个 实 参 (argument )， 即 调用 函数 时 传 
递 给 函数 的 信息 。 调 用 函数 时 ， 将 要 让 函数 使 用 的 信息 放 在 圆 括号 内 。 在 greet_user('jesse') 
中 ， 将 实 参 'jesse' 传 递 给 了 函数 greet_user()， 这 个 值 被 赋 给 了 形 参 username。 
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注意 ”大 家 有 时 候 会 形 参 、 实 参 不 分 ， 因 此 如 果 你 看 到 有 人 将 函数 定义 中 的 变量 称 为 实 参 或 将 
函数 调用 中 的 变量 称 为 形 参 ， 不 要 大 惊 小 怪 。 


动手 试 一 斌 
练习 8-1: 消息 编写 一 个 名 为 display message() 的 函数 ， 它 打印 一 个 句子 ， 指 出 
你 在 本 章 学 的 是 什么 。 调 用 这 个 函数 ， 确 认 显 示 的 消息 正确 无 误 。 


练习 8-2: 喜欢 的 图 书 ”编写 一 个 名 为 favorite book() 的 函数 ， 其 中 包含 一 个 名 为 


title 的 形 参 。 这 个 函数 打印 一 条 消息 ， 下 面 是 一 个 例子 。 
One of my favorite books is Alice in Wonderland. 


调用 这 个 函数 ， 并 将 一 本 图 书 的 名 称 作 为 实 参 传递 给 它 。 


8.2 ”传递 实 参 


函数 定义 中 可 能 包含 多 个 形 参 ,因此 函数 调用 中 也 可 能 包含 多 个 实 参 。 向 函数 传递 实 参 的 方 
式 很 多 : 可 使 用 位 置 实 参 ,这 要 求实 参 的 顺序 与 形 参 的 顺序 相同 ; 也 可 使 用 关键 字 实 参 ,其 中 每 
个 实 参 都 由 变量 名 和 值 组 成 ; 还 可 使 用 列表 和 字典 。 下 面 依次 介绍 这 些 方式 。 


8.2.1 位 置 实 参 
调用 函数 时 ，Python 必须 将 函数 调用 中 的 每 个 实 参 都 关联 到 函数 定义 中 的 一 个 形 参 。 为 此 ， 
最 简单 的 关联 方式 是 基于 实 参 的 顺序 。 这 种 关联 方式 称 为 位 置 实 参 。 


为 明白 其 中 的 工作 原理 , 来 看 一 个 显示 宠物 信息 的 函数 。 这 个 函数 指出 一 个 宠物 属于 哪 种 动 
物 以 及 它 叫 什么 名 字 ， 如 下 所 示 : 


pels.py ©@ def describe pet(animal type, pet name): 
mm 显示 完 物 的 信息 。""" 
print(f"\nI have a {animal type}." 
print(f"My {animal type}'s name is {pet name.title()}.") 


@ describe pet('hamster', 'harry') 


这 个 函数 的 定义 表明 ， 它 需要 一 种 动物 类 型 和 一 个 名 字 ( 见 @ )。 调 用 describe_pet() 时 ， 
需要 按 顺 序 提供 一 种 动物 类 型 和 一 个 名 字 。 例 如 ， 在 刚才 的 函数 调用 中 ， 实 参 'hamster' 被 赋 给 
形 参 animal type， 而 实 参 'harry ' 被 赋 给 形 参 pet_name ( 见 @ )。 在 函数 体内 ， 使 用 了 这 两 个 形 
参 来 显示 宠物 的 信息 。 
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输出 描述 了 一 只 名 为 Harry 的 仓鼠 : 


I have a hamster. 
My hamster's name is Harry. 


1. 多 次 调用 函数 
可 以 根据 需要 调用 函数 任意 次 。 要 再 描述 一 个 宠物 ， 只 需 再 次 调用 describe_pet() 即 可 : 


def describe pet(animal type, pet name): 
"" 显 示 宠 物 的 信息 。""" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet('hamster', 'harry') 
describe pet('dog', 'willie') 


第 二 次 调用 describe_pet() 函 数 时 ,向 它 传递 了 实 参 'dog' 和 'willie' ,与 第 一 次 调用 时 一 样 ， 
Python 将 实 参 'dog ' 关 联 到 形 参 animal type， 并 将 实 参 'willie' 关 联 到 形 参 pet_name。 与 前 面 一 
样 ， 这 个 函数 完成 了 任务 , 但 打印 的 是 一 条 名 为 Willie 的 小 狗 的 信息 。 至 此 ， 有 一 只 名 为 Harry 
的 仓鼠 ， 还 有 一 条 名 为 Willie 的 小 狗 : 


I have a hamster. 
My hamster's name is Harry. 


I have a dog. 
My dog's name is Willie. 


多 次 调用 函数 是 一 种 效率 极 高 的 工作 方式 。 只 需 在 函数 中 编写 一 次 描述 宠物 的 代码 ,然后 每 
当 需 要 描述 新 宠物 时 ， 都 调用 该 函数 并 向 它 提供 新 宠物 的 信息 。 即 便 描述 宠物 的 代码 增加 到 了 
10 行 ， 依 然 只 需 使 用 一 行 调用 函数 的 代码 ， 就 可 描述 一 个 新 宠物 。 


在 函数 中 , 可 根据 需要 使 用 任意 数量 的 位 置 实 参 , Python 将 按 顺序 将 函数 调用 中 的 实 参 关联 
到 函数 定义 中 相应 的 形 参 。 


2. 位 置 实 参 的 顺序 很 重要 
使 用 位 置 实 参 来 调用 函数 时 ， 如 果实 参 的 顺序 不 正确 ,结果 可 能 出 乎 意料 : 


def describe pet(animal . type, pet_name): 
"" 显 示 完 物 的 信息 。 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet('harry', 'hamster') 
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在 这 个 函数 调用 中 ， 先 指定 名 字 ， 再 指定 动物 类 型 。 由 于 实 参 'harry ' 在 前 ， 这 个 值 将 赋 给 
形 参 animal type。 同 理 ，'hamster ' 将 赋 给 形 参 pet_name。 结 果 是 有 一 个 名 为 Hamster 的 harry: 


I have a harry. 
My harry's name is Hamster. 


如 果 你 得 到 的 结果 像 上 面 一 样 可 笑 , 请 确认 函数 调用 中 实 参 的 顺序 与 函数 定义 中 形 参 的 顺序 
一 致 。 
8.2.2 ”关键 字 实 参 


关键 字 实 参 是 传递 给 函数 的 名 称 值 对 。 因 为 直接 在 实 参 中 将 名 称 和 值 关联 起 来 , 所 以 向 函数 
传递 实 参 时 不 会 混淆 ( 不 会 得 到 名 为 Hamster 的 harry 这 样 的 结果 )。 关键 字 实 参 让 你 无 须 考虑 函 
数 调 用 中 的 实 参 顺序 ， 还 清楚 地 指出 了 函数 调用 中 各 个 值 的 用 途 。 


下 面 来 重新 编写 pets.py， 在 其 中 使 用 关键 字 实 参 来 调用 describe pet(): 


def describe pet(animal type, pet name): 
"" "显示 完 物 的 信息 。""" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet(animal type="'hamster', pet name="harry') 


函数 describe_pet() 还 和 之 前 一 样 ， 但 调用 这 个 函数 时 ， 向 Python 明确 地 指出 了 各 个 实 参 
对 应 的 形 参 。 看 到 这 个 函数 调用 时 ，Python 知道 应 该 将 实 参 'hamster' 和 'harry' 分 别 赋 给 形 参 
animal_type 和 pet_name。 输 出 正确 无 误 ， 指 出 有 一 只 名 为 Harry 的 仓鼠 。 


关键 字 实 参 的 顺序 无 关 紧 要 ， 因 为 Python 知道 各 个 值 该 赋 给 哪个 形 参 。 下 面 两 个 函数 调用 
是 等 效 的 : 


describe pet(animal type="'hamster', pet name="harry') 
describe pet(pet name="'harry', animal type="'hamster') 


注意 ”使 用 关键 字 实 参 时 ， 务 必 准 确 指定 函数 定义 中 的 形 参 名 。 


8.2.3 默认 值 


编写 函数 时 ,可 给 每 个 形 参 指定 默认 值 。 在 调用 函数 中 给 形 参 提供 了 实 参 时 , Python 将 使 用 
站 定 的 实 参 值 ; 否则 ,将 使 用 形 参 的 默认 值 。 因 此 ， 给 形 参 指定 默认 值 后 ， 可 在 函数 调用 中 省 略 
相应 的 实 参 。 使 用 默认 值 可 简化 函数 调用 ， 还 可 清楚 地 指出 函数 的 典型 用 法 。 


例如 ， 如 果 你 发 现 调用 describe_pet() 时 ， 描 述 的 大 多 是 小 狗 ， 就 可 将 形 参 animal type 的 
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默认 值 设 置 为 "dog 。 这 样 ， 调 用 describe _pet() 来 描述 小 狗 时 ， 就 可 不 提供 这 种 信息 : 


def describe pet(pet name， animal type='dog ') : 
”显示 宠物 的 信息 
print(f"\nI have a ee ) 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet(pet name="'willie') 


这 里 修改 了 函数 describe_pet() 的 定义 , 在 其 中 给 形 参 animal_type 指定 了 默认 值 ' dog'。 这 
样 ， 调 用 这 个 函数 时 ， 如 果 没 有 给 animal type 指定 值 ，Python 就 将 把 这 个 形 参 设置 为 ' dog' : 


I have a dog. 
My dog's name is Willie. 


请 注意 , 在 这 个 函数 的 定义 中 , 修改 了 形 参 的 排列 顺序 。 因 为 给 We 指定 了 默认 值 ， 
无 须 通过 实 参 来 指定 动物 类 型 , 所 以 在 函数 调用 中 只 包含 一 -1 然而 ,Python 
依然 将 这 个 实 参 视 为 位 置 实 参 , 因此 如 果 函 数 调用 中 只 人 这 个 实 参 将 关联 到 本 数 
定义 中 的 第 一 个 形 参 。 这 就 是 需要 将 pet_name 放 在 形 参 列表 开头 的 原因 。 


现在 ， 使 用 这 个 函数 的 最 简单 方式 是 在 函数 调用 中 只 提供 小 狗 的 名 字 : 


describe pet('willie') 


这 个 函数 调用 的 输出 与 前 一 个 示例 相同 。 只 提供 了 一 个 实 参 'willie' ， 这 个 实 参 将 关联 到 函 
数 定义 中 的 第 一 个 形 参 pet_name。 由 于 没有 给 animal_type 提供 实 参 ,Python 将 使 用 默认 值 'dog'。 


如 果 要 描述 的 动物 不 是 小 狗 ， 可 使 用 类 似 于 下 面 的 函数 调用 : 


describe pet(pet name='harry', animal type="'hamster') 


由 于 显 式 地 给 animal_type 提供 了 实 参 ，Python 将 忽略 这 个 形 参 的 默认 值 。 
注意 使 用 默认 值 时 ， 必 须 先 在 形 参 列表 中 列 出 没有 默认 值 的 形 参 ， 再 列 出 有 默认 值 的 实 参 
这 让 Python 依然 能 够 正确 地 解读 位 置 实 参 。 


8.2.4 等 效 的 函数 调用 


鉴于 可 混合 使 用 位 置 实 参 、 关 键 字 实 参 和 默认 值 , 通常 有 多 种 等 效 的 函数 调用 方式 。 请 看 下 
面 对 函 数 descripe_pet() 的 定义 ， 其 中 给 一 个 形 参 提 供 了 默认 值 : 


def describe pet(pet name, animal type= dog ' ) : 


8.2 传递 实 参 121 


基于 这 种 定义 ,在 任何 情况 下 都 必须 给 pet_name 提供 实 参 。 指 定 该 实 参 时 可 采用 位 置 方式 ， 
也 可 采用 关键 字 方 式 。 如 果 要 描述 的 动物 不 是 小 狗 ， 还 必须 在 函数 调用 中 给 animal_type 提供 实 
参 。 同 样 ， 指 定 该 实 参 时 可 以 采用 位 置 方式 ， 也 可 采用 关键 字 方 式 。 


下 面 对 这 个 函数 的 所 有 调用 都 可 行 : 


# 一 条 名 为 Willie 的 小 狗 。 
describe pet('willie') 
describe pet(pet name="'willie') 


# 一 只 名 为 Harry 的 仓鼠 。 

describe pet('harry', 'hamster') 

describe pet(pet name='harry', animal type="'hamster') 
describe pet(animal type="'hamster', pet name="harry') 


这 些 函 数 调用 的 输出 与 前 面 的 示例 相同 。 


注意 ”使 用 哪 种 调用 方式 无 关 紧 要 ， 只 要 函数 调用 能 生成 你 期 望 的 输出 就 行 。 使 用 对 你 来 说 最 cl 
容易 理解 的 调用 方式 即 可 。 


8.2.5 ”避免 实 参 错误 


等 你 开始 使 用 函数 后 ， 如 果 遇 到 实 参 不 匹配 错误 ,不 要 大 惊 小 怪 。 你 提供 的 实 参 多 于 或 少 于 
函数 完成 工作 所 需 的 信息 时 ,将 出 现实 参 不 匹配 错误 。 例 如， 如 果 调 用 函数 describe_pet() 时 没 
有 指定 任何 实 参 ， 结 果 将 如 何 呢 ? 


def describe pet(animal type, pet name): 
""" 显 示 完 物 的 信息 。""" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet() 


Python 发 现 该 函数 调用 缺少 必要 的 信息 ，traceback 指出 了 这 一 点 : 


Traceback (most recent call last): 

@ File "pets.py", line 6, in <module> 

@ describe pet() 

@ TypeError: describe pet() missing 2 required positional arguments: 'animal_ 
type' and 'pet name’ 


在 @ 处 ，traceback 指出 了 问题 出 在 什么 地 方 ， 让 我 们 能 够 回 过 头 去 找 出 函数 调用 中 的 错误 。 
在 @ 处 , 指出 了 导致 问题 的 函数 调用 。 在 @ 处 ，traceback 指出 该 函数 调用 少 了 两 个 实 参 ， 并 指出 
了 相应 形 参 的 名 称 。 如 果 这 个 函数 存储 在 一 个 独立 的 文件 中 , 我 们 也 许 无 须 打 开 这 个 文件 并 查看 
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函数 的 代码 ， 就 能 重新 正确 地 编写 函数 调用 。 


bl 


Python 读 取 函 数 的 代码 并 指出 需要 为 哪些 形 参 提供 实 参 , 这 提供 了 极 大 的 帮助 。 这 也 是 应 该 
给 变量 和 函数 指定 描述 性 名 称 的 男 一 个 原因 : 如 果 这 样 做 了 , 那么 无 论 对 于 你 ,还 是 可 能 使 用 你 


编写 的 代码 的 其 他 任何 人 来 说 ，Python 提供 的 错误 消息 都 将 更 有 帮助 。 
如 果 提 供 的 实 参 太 多 ， 将 出 现 类 似 的 traceback， 帮 助 你 确保 函数 调用 和 函数 定义 匹配 。 


动手 试 一 斌 


练习 8-3: T 几 ”编写 一 个 名 为 make shirt() 的 函数 ， 它 接受 一 个 尺码 以 及 要 印 到 
工 必 上 的 字样 。 这 个 函数 应 打印 一 个 甸子 ， 概 要 地 说 明 工 恤 的 尺码 和 字样 。 

使 用 位 置 实 参 调用 该 函数 来 制作 一 件 工 必 ， 再 使 用 关键 字 实 参 来 调用 这 个 函数 。 

练习 8-4: 大 号 了 恤 ”修改 函数 make shirt(),， 使 其 在 默认 情况 下 制作 一 件 印 有 
“I love Python” 字 样 的 大 号 工 恤 。 调 用 这 个 函数 来 制作 : 一 件 印 有 默认 字样 的 大 号 工 


恤 ， 一 件 印 有 默认 字样 的 中 号 了 恤 ， 以 及 一 件 印 有 其 他 字样 的 工 恤 〔 尺 码 无 关 紧要 )。 
练习 8-5: 城市 ”编写 一 个 名 为 describe city() 的 函数 ， 它 接受 一 座 城 市 的 名 字 
以 及 该 城市 所 属 的 国家 。 这 个 函数 应 打印 一 个 简单 的 句子 ， 下 面 是 一 个 例子 。 
Reykjavik is in Iceland. 
给 用 于 存储 国家 的 形 参 指定 默认 值 。 为 三 座 不 同 的 城市 调用 这 个 函数 ， 且 其 中 至 少 
有 一 座 城市 不 属于 默认 国家 。 


8.3 返回 值 


函数 并 非 总 是 直接 显示 输出 ， 它 还 可 以 处 理 一 些 数据 , 并 返回 一 个 或 一 组 值 。 函 数 返回 的 值 
称 为 返回 值 。 在 函数 中 ， 可 使 用 return 语句 将 值 返回 到 调用 函数 的 代码 行 。 返 回 值 让 你 能 够 将 


程序 的 大 部 分 繁重 工作 移 到 函数 中 去 完成 ， 从 而 简化 主 程序 。 


8.3.1 返回 简单 值 
下 面 来 看 一 个 函数 ， 它 接受 名 和 姓 并 返回 整洁 的 姓名 : 


formatied. @@ def get formatted name(first name, last name): 
pep "0" 返 加 整洁 的 嫂 名 ， "0" 
© full name = f"{first name} {last name}" 
(3 return full name.title() 
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@ musician = get formatted name('jimi', 'hendrix') 
print(musician) 


函数 get_formatted_name() 的 定义 通过 形 参 接受 名 和 姓 ( 见 @ ), 它 将 姓 和 名 合 而 为 一 , 在 中 
间 加 上 一 个 空格 ， 并 将 结果 赋 给 变量 full_name ( 见 @ )。 然 后 ， 将 full_name 的 值 转换 为 首 字母 
大 写 格 式 ， 并 将 结果 返回 到 函数 调用 行 ( 见 @ )。 

调用 返回 值 的 函数 时 , 需要 提供 一 个 变量 ,以 便 将 返回 的 值 赋 给 它 。 在 这 里 ,将 返回 值 赋 给 
了 变量 musician( 见 @ )。 输 出 为 整洁 的 姓名 : 


Jimi Hendrix 


原本 只 需 编写 下 面 的 代码 就 可 输出 整洁 的 姓名 ， 相 比 于 此 ， 前 面 做 的 工作 好 像 太 多 了 : 


print("Jimi Hendrix") 


但 在 需要 分 别 存储 大 量 名 和 姓 的 大 型 程序 中 , 像 get_formatted_name() 这 样 的 函数 非常 有 用 。 8 


可 以 分 别 存储 名 和 姓 ， 每 当 需 要 显示 姓名 时 都 调用 这 个 函数 。 


8.3.2 ”让 实 参 变 成 可 选 的 

有 时 候 , 需要 让 实 参 变 成 可 选 的 , 这 样 使 用 函数 的 人 就 能 只 在 必要 时 提供 额外 的 信息 。 可 使 
用 默认 值 来 让 实 参 变 成 可 选 的 。 

例如 ,假设 要 扩展 函数 get_formatted_name()， 使 其 同时 处 理 中 间 名 。 为 此 ， 可 将 其 修改 成 
类 似 于 下 面 这 样 : 


def get formatted name(first name, middle name, last name): 
Wn 鬼 回 整 洁 的 姓名 。""" 
full name = f"{first name} {middle name} {last name}" 
return full name.title() 


musician = get formatted name('john', 'lee', 'hooker') 
print(musician) 


只 要 同时 提供 名 、 中 间 名 和 姓 ， 这 个 函数 就 能 正确 运行 。 它 根据 这 三 部 分 创建 一 个 字符 串 ， 
在 适当 的 地 方 加 上 空格 ， 并 将 结果 转换 为 首 字 母 大 写 格式 : 


John Lee Hooker 


并 非 所 有 的 人 都 有 中 间 名 ， 但 如 果 调 用 这 个 函数 时 只 提供 了 名 和 姓 ， 它 将 不 能 正确 运行 。 为 
了 让 中 间 名 变 成 可 选 的 ， 可 给 形 参 middle_name 指定 一 个 空 的 默认 值 ， 并 在 用 户 没有 提供 中 间 名 时 
不 使 用 这 个 形 参 。 为 让 get_formatted_name() 在 没有 提供 中 间 名 时 依然 可 行 , 可 将 形 参 middle_name 


124 第 8 章 函数 


的 默认 值 设置 为 空 字符 串 ， 并 将 其 移 到 形 参 列 表 的 末尾 : 


@ def get formatted name(first name, last name, middle name=""'): 
"" "返回 整 洁 的 姓名 。""" 


© if middle name: 

full name = f"{first name} {middle name} {last name}" 
@ else: 

full name = f"{first name} {last name}" 


return full name.title() 


musician = get formatted name('jimi', 'hendrix') 
print(musician) 


@ musician = get formatted name('john', 'hooker', 'lee') 
print (musician) 


在 本 例 中 , 姓名 是 根据 三 个 可 能 提供 的 部 分 创建 的 。 由 于 人 都 有 名 和 姓 ， 因 此 在 函数 定义 中 
首先 列 出 了 这 两 个 形 参 。 中 间 名 是 可 选 的 ,因此 在 函数 定义 中 最 后 列 出 该 形 参 ,， 并 将 其 默认 值 设 
置 为 空 字符 串 ( 见 @@ )。 

在 函数 体 中 ， 检 查 是 否 提供 了 中 间 名 。Python 将 非 空 字符 串 解读 为 True， 因 此 如 果 函 数 调 
用 中 提供 了 中 间 名 ，if middle_name 将 为 True ( 见 @ )。 如 果 提 供 了 中 间 名 ， 就 将 名 、 中 间 名 和 
姓 合 并 为 姓名 ， 再 将 其 修改 为 首 字 母 大 写 格式 ， 并 返回 到 函数 调用 行 。 在 函数 调用 行 , 将 返回 的 
值 赋 给 变量 musician， 然 后 这 个 变量 的 值 被 打印 出 来 。 如 果 没 有 提供 中 间 名 ，middle_name 将 为 
空 字 符 串 ， 导 致 if 测试 未 通过 ， 进 而 执行 else 代码 块 ( 见 @ ): 只 使 用 名 和 姓 来 生成 姓名 ， 并 
将 格式 设置 好 的 姓名 返回 给 函数 调用 行 。 在 函数 调用 行 , 将 返回 的 值 赋 给 变量 musician, 然后 这 
个 变量 的 值 被 打印 出 来 。 

调用 这 个 函数 时 ， 如 果 只 想 指 定名 和 姓 ， 调 用 起 来 将 非常 简单 。 如 果 还 要 指定 中 间 名 ， 就 必 
须 确 保 它 是 最 后 一 个 实 参 ， 这 样 Python 才能 正确 地 将 位 置 实 参 关联 到 形 参 ( 见 @ )。 

这 个 修改 后 的 版 本 不 仅 适 用 于 只 有 名 和 姓 的 人 ， 而 且 适 用 于 还 有 中 间 名 的 人 : 


Jimi Hendrix 
John Lee Hooker 


可 选 值 让 函数 能 够 处 理 各 种 不 同 的 情形 ， 同 时 确保 函数 调用 尽 可 能 简单 。 


8.3.3 返回 字典 


函数 可 返回 任何 类 型 的 值 , 包括 列表 和 字典 等 较 复 杂 的 数据 结构 。 例 如 ， 下 面 的 函数 接受 姓 
名 的 组 成 部 分 ， 并 返回 一 个 表示 人 的 字典 : 


person.py def build person(first name, last name): 
""" 返 回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 。""" 
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@ person = { first': first name， 'last': last name} 
© return person 


musician = build person('jimi', 'hendrix') 
@ print(musician) 


函数 build_person() 接 受 名 和 姓 ， 并 将 这 些 值 放 到 字典 中 ( 见 @ ), 存储 first_name 的 值 时 ， 
使 用 的 键 为 'first' ， 而 存储 last_name 的 值 时 ， 使 用 的 键 为 "last' 。 最 后 ， 返 回 表 示人 的 整个 
字典 ( 见 @ )。 在 @ 处 ,打印 这 个 返回 的 值 ， 此 时 原来 的 两 项 文本 信息 存储 在 一 个 字典 中 : 


{'first': 'jimi', 'last': 'hendrix'} 


这 个 函数 接受 简单 的 文本 信息 , 并 将 其 放 在 一 个 更 合适 的 数据 结构 中 , 让 你 不 仅 能 打印 这 些 
信息 , 还 能 以 其 他 方式 处 理 它们 。 当 前 , 字符 串 'jimi' 和 'hendrix' 被 标记 为 名 和 姓 。 你 可 以 轻松 
地 扩展 这 个 函数 ,使 其 接受 可 选 值 ， 如 中 间 名 、 年 龄 、 职 业 或 其 他 任何 要 存储 的 信息 。 例 如 ， 下 
面 的 修改 让 你 能 存储 年 龄 : 


def build person(first name, last name, age=None): 
""" 返 回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 。”""" 
person = {'first': first name， 'last': last name} 
if age: 
person['age'] = age 
return person 


musician = build person('jimi', 'hendrix', age=27) 
print(musician) 


在 函数 定义 中 ， 新 增 了 一 个 可 选 形 参 age， 并 将 其 默认 值 设置 为 特殊 值 None ( 表示 变量 没有 
值 )。 可 将 None 视 为 占 位 值 。 在 条 件 测试 中 ，None 相当 于 False。 如 果 函 数 调用 中 包含 形 参 age 
的 值 ， 这 个 值 将 被 存储 到 字典 中 。 在 任何 情况 下 ， 这 个 函数 都 会 存储 人 的 姓名 ， 但 可 进行 修改 ， 
使 其 同时 存储 有 关 人 的 其 他 信息 。 


8.3.4 结合 使 用 函数 和 while 循环 


可 将 函数 同 本 书 前 面 介 绍 的 任何 Python 结构 结合 起 来 使 用 。 例 如 ， 下 面 将 结合 使 用 函数 
get_formatted_name() 和 while 循环 ， 以 更 正式 的 方式 问候 用 户 。 下 面 尝试 使 用 名 和 姓 跟 用 户 打 
招呼 : 


greeterpy def get formatted name(first name, last name): 
""" 返 回 整 洁 的 姓名 。"" 
full name = f"{first name} {last name}" 
return full name.title() 


# 这 是 一 个 无 限 循环 ! 
while True: 
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@ print("\nplease tell me your name:") 


f_name = 
] name = 


input("First name: ") 
input("Last name: ") 


formatted name = get formatted name(f name, 1 name) 
print(f"\nHello, {formatted name}!") 


在 本 例 中 ， 使 月 


输入 姓名 : 依次 提示 用 户 输入 名 和 姓 ( 见 @ )。 
但 这 个 while 循环 存在 一 个 问题 : 没有 定义 退出 条 件 。 请 用 户 提 供 一 系列 输入 时 ， 该 在 什么 


有 的 是 get formatted name() 的 简单 版 本 ， 不 涉及 中 间 名 。while 循环 让 用 户 


地 方 提 供 退出 途径 呢 ? 要 让 用 户 能 够 尽 可 能 容易 地 退出 , 因此 每 次 提示 用 户 输入 时 , 都 应 提供 退 


出 途径 。 每 次 提示 用 户 输入 时 ， 都 使 用 break 语句 提供 退出 循环 的 简单 途径 : 


def 


get format 


full name = f"{firs 
return full name.tit 


ted name(first name, last name): 
"0" 授 加 整洁 的 嫂 名 ， "0" 
t name} {last name}" 


while True: 
print("\nplease tell me your name:") 
print("(enter 'q' at any time to quit)") 
f name = input("First name: ") 
if f name == 'q : 
break 
| name = input("Last name: ") 
if 1 name == 'q': 
break 


formatted name = get formatted name(f name, 1 name) 
print(f"\nHello, {formatted name}!") 


我 1 


否 是 退出 值 。 如 果 是 


] 添 加 了 一 条 消息 来 告诉 用 户 如 何 退 出 ， 
, 就 退出 循环 。 现 在 , 这 个 程序 将 不 断 地 问候 , 直到 用 户 输入 的 姓 或 名 为 'q' : 


然后 在 每 次 提示 用 户 输入 时 , 都 检查 他 输入 的 是 


First name: eric 


Hello， 


First name: q 


Last name: matthes 


Eric Matthes! 


Please tell me your name: 
(enter 'q' at any time to quit) 


Please tell me your name: 
(enter 'q' at any time to quit) 
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练习 8-6: 城市 名 编写 一 个 名 为 city country() 的 函数 ， 它 接受 城市 的 名 称 及 其 
所 属 的 国家 。 这 个 函数 应 返回 一 个 格式 类 似 于 下 面 的 字符 串 : 


"Santiago, Chile" 


至 少 使 用 三 个 城市 国家 对 来 调用 这 个 函数 ， 并 打印 它 返回 的 值 。 
练习 8-7: 专辑 编写 一 个 名 为 make album() 的 函数 ， 它 创建 一 个 描述 音乐 专辑 的 
字典 。 这 个 函数 应 接受 歌手 的 名 字 和 专辑 名 ， 并 返回 一 个 包含 这 两 项 信息 的 字典 。 使 用 


这 个 函数 创建 三 个 表示 不 同 专辑 的 字典 , 并 打印 每 个 返回 的 值 ， 以 核实 字典 正确 地 存储 
了 专辑 的 信息 。 


给 函数 make album() 添 加 一 个 默认 值 为 None 的 可 选 形 参 ， 以 便 存 储 专辑 包含 的 歌 
曲 数 。 如 果 调 用 这 个 函数 时 指定 了 歌曲 数 ， 就 将 该 值 添加 到 表示 专辑 的 字典 中 。 调用 这 
个 函数 ， 并 至 少 在 一 次 调用 中 指定 专辑 包含 的 歌曲 数 。 

练习 8-8: 用 户 的 专辑 在 为 完成 练习 8-7 编写 的 程序 中 ， 编 写 一 个 while 循环 ， 
让 用 户 输入 专辑 的 歌手 和 名 称 。 获 取 这 些 信息 后 ,使 用 它们 来 调用 函数 make album() 
并 将 创建 的 字典 打印 出 来 。 在 这 个 while 循环 中 ,务必 提供 退出 途径 。 


8.4 传递 列表 
你 经 常会 发 现 ， 向 函数 传递 列表 很 有 用 ， 其 中 包含 的 可 能 是 名 字 、 数 或 更 复杂 的 对 象 ( 如 字 
典 )。 将 列表 传递 给 函数 后 ， 函 数 就 能 直接 访问 其 内 容 。 下 面 使 用 函数 来 提高 处 理 列表 的 效率 。 


假设 有 一 个 用 户 列 表 , 我 们 要 问候 其 中 的 每 位 用 户 。 下面 的 示例 将 包含 名 字 的 列表 传递 给 一 
个 名 为 greet_users() 的 函数 ， 这 个 函数 问候 列表 中 的 每 个 人 : 


greet users.py def greet users(names): 
""" 向 列表 中 的 每 位 用 户 发 出 简单 的 问候 。""" 
for name in names: 
msg = f"Hello, {name.title()}!" 
print(msg) 


@ usernames = ['hannah', 'ty', 'margot'] 
greet users(usernames) 


我 们 将 greet_users() 定 义 为 接受 一 个 名 字 列 表 , 并 将 其 赋 给 形 参 names。 这 个 函数 遍历 收 到 
的 列表 ， 并 对 其 中 的 每 位 用 户 打 印 一 条 问候 语 。@ 处 定义 了 一 个 用 户 列表 usernames ， 然 后 调用 
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greet_users() 并 将 该 列表 传递 给 它 : 


Hello, Hannah! 
Hello, Ty! 
Hello, Margot! 


输出 完全 符合 预期 。 每 位 用 户 都 看 到 了 一 条 个 性 化 的 问候 语 。 每 当 需 要 问候 一 组 用 户 时 , 都 


可 调用 这 个 函数 。 
8.4.1 在 函数 中 修改 列表 


将 列表 传递 给 函数 后 ， 函 数 就 可 对 其 进行 修改 。 在 函数 中 对 这 个 列表 所 做 的 任何 修改 都 是 永 


久 性 的 ， 这 让 你 能 够 高 效 地 处 理 大 量 数据 。 


来 看 一 家 为 用 户 提 交 的 设计 制作 3D 打印 模型 的 公司 。 需 要 打印 的 设计 存储 在 一 个 列表 中 ， 


打印 后 将 移 到 另 一 个 列表 中 。 下 面 是 在 不 使 用 函数 的 情况 下 模拟 这 个 过 程 的 代码 : 


Prinfing_ 


# 首先 创建 一 个 列表 ， 其 中 包含 一 些 要 打印 的 设计 。 


models.py unprinted designs = ['phone case', 'robot pendant', 'dodecahedron'] 


completed models = [] 


# 模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 。 

# 打印 每 个 设计 后 ， 都 将 其 移 到 列表 completed models 中 。 

while unprinted _ designs : 
current design = unprinted designs.pop() 
print(f"Printing model: {current design}") 
completed models.append(current design) 


# 显示 打印 好 的 所 有 模型 。 

print("\nThe following models have been printed:") 

for completed model in completed models: 
print(completed model) 


这 个 程序 首先 创建 一 个 需要 打印 的 设计 列表 , 以 及 一 个 名 为 completed models 的 空 列表 , 每 


个 设计 打印 后 都 将 移 到 其 中 。 只 要 列表 unprinted designs 中 还 有 设计 ，while 循环 就 模拟 打印 
设计 的 过 程 : 从 该 列表 末尾 删除 一 个 设计 ,将 其 赋 给 变量 current_design, 并 显示 一 条 消息 指出 
正在 打印 当前 的 设计 , 然后 将 该 设计 加 入 到 列表 completed models 中 。 循环 结束 后 ,显示 已 打印 
的 所 有 设计 : 


Printing model: dodecahedron 
Printing model: robot pendant 
Printing model: phone case 


The following models have been printed: 
dodecahedron 

robot pendant 

phone case 


8.4 传递 列表 129 


为 重新 组 织 这 些 代 码 , 可 编写 两 个 函数 , 每 个 都 做 一 件 具体 的 工作 。 大 部 分 代码 与 原来 相同 ， 
只 是 效率 更 高 。 第 一 个 函数 负责 处 理 打印 设计 的 工作 ,第 二 个 概述 打印 了 哪些 设计 : 


@ def print models(unprinted designs, completed models) 


模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 。 
打印 每 个 设计 后 ， 都 将 其 移 到 列表 completed models 中 。 


while unprinted designs: 
current design = unprinted designs.pop() 
print(f"Printing model: {current design}") 
completed models.append(current design) 


@ def show completed models(completed models): 
"" "显示 打印 好 的 所 有 模型 。""" 
print("\nThe following models have been printed:") 
for completed model in completed models: 
print(completed model) 


unprinted designs = ['phone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


print models(unprinted designs, completed models) 
show completed models(completed models) 


加 处 定义 了 函数 print_models() ， 它 包含 两 个 形 参 : 一 个 需要 打印 的 设计 列表 和 一 个 打印 好 
的 模型 列表 。 给 定 这 两 个 列表 ,该 函数 模拟 打印 每 个 设计 的 过 程 : 将 设计 逐个 从 未 打印 的 设计 列 
表 中 取出 , 并 加 入 打印 好 的 模型 列表 中 。@@ 处 定义 了 郴 数 show_completed_models(), 它 包含 一 个 
形 参 : 打印 好 的 模型 列表 。 给 定 这 个 列表 ， 函 数 show_completed_models() 显 示 打 印 出 来 的 每 个 
模型 的 名 称 。 


这 个 程序 的 输出 与 未 使 用 函数 的 版 本 相同 , 但 组 织 更 为 有 序 。 完 成 大 部 分 工作 的 代码 都 移 到 
了 两 个 函数 中 ， 让 主 程序 更 容易 理解 。 只 要 看 看 主 程序 ， 就 会 发 现 这 个 程序 的 功能 清晰 得 多 : 


unprinted designs = ['phone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


print models(unprinted designs, completed models) 
show completed models(completed models) 


我 们 创建 了 一 个 未 打印 的 设计 列表 , 还 创建 了 一 个 空 列表 , 用 于 存储 打印 好 的 模型 。 接 下 来 ， 
由 于 已 经 定义 了 两 个 函数 ， 只 需 调 用 它们 并 传人 正确 的 实 参 即 可 。 我 们 调用 print_models() 并 向 
它 传 递 两 个 列表 。 像 预期 一 样 ，print_models() 模 拟 打 印 设计 的 过 程 。 接 下 来 ， 调 用 
show_completed_models()， 并 将 打印 好 的 模型 列表 传递 给 它 ， 让 其 能 够 指出 打印 了 哪些 模型 。 措 
述 性 的 函数 名 让 别人 阅读 这 些 代码 时 也 能 明白 ， 尽 管 没 有 任何 注释 。 
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相 比 于 没有 使 用 函数 的 版 本 ， 这 个 程序 更 容易 扩展 和 维护 。 如 果 以 后 需要 打印 其 他 设计 ， 
只 需 再 次 调用 print_models() 即 可 。 如 果 发 现 需要 对 打印 代码 进行 修改 ， 只 需 修 改 这 些 代 码 一 
次 ， 就 能 影响 所 有 调用 该 函数 的 地 方 。 与 必须 分 别 修 改 程序 的 多 个 地 方 相 比 ， 这 种 修改 的 效率 
更 


该 程序 还 演示 了 这 样 一 种 理念 : 每 个 函数 都 应 只 负责 一 项 具体 的 工作 。 第 一 个 函数 打印 每 个 
设计 , 第 二 个 显示 打印 好 的 模型 。 这 优 于 使 用 一 个 函数 来 完成 这 两 项 工作 。 编 写 函 数 时 ， 如 果 发 
现 它 执行 的 任务 太 多 , 请 尝试 将 这 些 代 码 划分 到 两 个 函数 中 。 别 忘 了 ， 总 是 可 以 在 一 个 函数 中 调 
用 男 一 个 函数 ， 这 有 助 于 将 复杂 的 任务 划分 成 一 系列 步骤 。 


8.4.2 ”禁止 函数 修改 列表 


有 了 时候 ,需要 禁止 函数 修改 列表 。 例如, 假设 像 前 一 个 示例 那样 ,你 有 一 个 未 打印 的 设计 列 
表 , 并 编写 了 一 个 函数 将 这 些 设计 移 到 打印 好 的 模型 列表 中 。 你 可 能 会 做 出 这 样 的 决定 : 即便 打 
印 好 了 所 有 设计 ,也 要 保留 原来 的 未 打印 的 设计 列表 ,以 供 备 案 。 但 由 于 你 将 所 有 的 设计 都 移出 
了 unprinted_designs， 这 个 列表 变 成 了 空 的 ， 原 来 的 列表 没有 了 。 为 解决 这 个 问题 ， 可 疝 函 数 
传递 列表 的 副本 而 非 原件 。 这 样 ， 函 数 所 做 的 任何 修改 都 只 影响 副本 ， 而 原件 丝毫 不 受 影响 。 


要 将 列表 的 副本 传递 给 函数 ， 可 以 像 下 面 这 样 做 : 


function name( 1ist namel:]) 


切片 表示 法 [:] 创 建 列表 的 副本 。 在 printing_models.py 中 , 如 果 不 想 清 空 未 打印 的 设计 列表 ， 
可 像 下 面 这 样 调用 print_models(): 


print models(unprinted designs[:], completed models) 


这 样 函 数 print_models() 依 然 能 够 完成 工作 ， 因 为 它 获 得 了 所 有 未 打印 的 设计 的 名 称 , 但 使 
用 的 是 列表 unprinted designs 的 副本 ,而 不 是 列表 unprinted_designs 本 身 。 像 以 前 一 样 ,列表 
completed models 也 将 包含 打印 好 的 模型 的 名 称 ， 但 函数 所 做 的 修改 不 会 影响 到 列表 


unprinted designs。 

虽然 向 函数 传递 列表 的 副本 可 保留 原始 列表 的 内 容 , 但 除非 有 充分 的 理由 ,否则 还 是 应 该 将 
原始 列表 传递 给 函数 。 这 是 因为 让 函数 使 用 现成 的 列表 可 避免 花 时 间 和 内 存 创 建 副 本 ,从 而 提高 
效率 ， 在 处 理 大 型 列表 时 尤其 如 此 。 


动手 试 一 斌 


练习 8-9: 消息 创建 一 个 列表 ， 其 中 包含 一 系列 简短 的 文本 消息 。 将 该 列表 传递 
给 一 个 名 为 show messages() 的 函数 ， 这 个 函数 会 打印 列表 中 的 每 条 文本 消息 。 
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练习 8-10: 发 送 消息 在 你 为 完成 练习 8-9 而 编写 的 程序 中 ， 编 写 一 个 名 为 send 
messages() 的 函数 ， 将 每 条 消息 都 打印 出 来 并 移 到 一 个 名 为 sent messages 的 列表 中 。 
调用 函数 send_ messages()， 再 将 两 个 列表 都 打印 出 来 ， 确 认 正 确 地 移动 了 消息 。 


练习 8-11: 消息 归档 修改 你 为 完成 练习 8-10 而 编写 的 程序 ， 在 调用 函数 send 
messages() 时 ， 向 它 传 递 消息 列表 的 副本 。 调 用 函数 send messages() 后 , 将 两 个 列表 都 
打印 出 来 ， 确 认 保留 了 原始 列表 中 的 消息 。 


8.5 ”传递 任意 数量 的 实 参 

有 时候 ， 预 完 不 知道 函数 需要 接受 多 少 个 实 参 ， 好 在 Python 允许 函数 从 调用 语句 中 收集 任 
意 数 量 的 实 参 。 

例如 , 来 看 一 个 制作 比萨 的 孔 数 , 它 需 要 接受 很 多 配料 , 但 无 法 预先 确定 顾客 要 多 少 种 配料 。 
下 面 的 函数 只 有 一 个 形 参 *toppings， 但 不 管 调用 语句 提供 了 多 少 实 参 ， 这 个 形 参 会 将 它们 统统 
收入 暑 中 : 


pizza.py def make pizza(*toppings): 
""" 打 印 顾客 点 的 所 有 配料 。""" 
print(toppings) 


make pizza('pepperoni') 
make_pizza('mushrooms', 'green peppers', 'extra cheese') 


形 参 名 *toppings 中 的 星 号 让 Python 创建 一 个 名 为 toppings 的 空 元 组 , 并 将 收 到 的 所 有 值 都 
封装 到 这 个 元 组 中 。 函 数 体内 的 函数 调用 print() 通 过 生成 输出 , 证明 Python 能 够 处 理 使 用 一 个 
值 来 调用 冰 数 的 情形 , 也 能 处 理 使 用 三 个 值 来 调用 函数 的 情形 。 它 以 类 似 的 方式 处 理 不 同 的 调用 。 
注意 ，Python 将 实 参 封 装 到 一 个 元 组 中 ， 即 便 函 数 只 收 到 一 个 值 : 


( pepperoni ，) 
('mushrooms', "green peppers', 'extra Cheese ' ) 


现在 ， 可 以 将 函数 调用 print() 替 换 为 一 个 循环 ， 遍 历 配料 列表 并 对 顾客 点 的 比萨 进行 描述 : 


def make pizza(*toppings) 
"" "概述 要 制作 的 比萨 。""" 
print("\nMaking a pizza with the following toppings:") 
for topping in toppings: 
print(f"- {topping}") 


make pizza('pepperoni') 
make pizza('mushrooms', 'green peppers', 'extra cheese') 
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不 管 收 到 一 个 值 还 是 三 个 值 ， 这 个 函数 都 能 妥善 处 理 : 


Making a pizza with the following toppings: 
- pepperoni 


Making a pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


不 管 函 数 收 到 的 实 参 是 多 少 个 ， 这 种 语法 都 管用 。 


8.5.1 ”结合 使 用 位 置 实 参 和 任意 数量 实 参 
如 果 要 让 函数 接受 不 同类 型 的 实 参 ， 必 须 在 函数 定义 中 将 接纳 任意 数量 实 参 的 形 参 放 在 最 
后 。Python 先 匹 配 位 置 实 参 和 关键 字 实 参 ， 再 将 余下 的 实 参 都 收集 到 最 后 一 个 形 参 中 。 


例如 ， 如 果 前 面 的 函数 还 需要 一 个 表示 比萨 尺寸 的 形 参 ,必须 将 其 放 在 形 参 *toppings 的 
前 面 : 


def make pizza(size, *toppings): 
"" "概述 要 制作 的 比萨 
print(f"\nMaking a {size}-inch pizza with the following toppings:") 
for topping in toppings: 
print(f"- {topping}") 


make pizza(16, 'pepperoni') 
make_ pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


基于 上 述 函 数 定义 ，Python 将 收 到 的 第 一 个 值 赋 给 形 参 size， 并 将 其 他 所 有 值 都 存储 在 元 组 
toppings 中 。 在 函数 调用 中 ， 首 先 指 定 表示 比萨 尺寸 的 实 参 ， 再 根据 需要 指定 任意 数量 的 配料 。 

现在 , 每 个 比萨 都 有 了 尺寸 和 一 系列 配料 , 而 且 这 些 信息 按 正确 的 顺序 打印 出 来 了 一 一 首先 
是 尺寸 ， 然 后 是 配料 : 


Making a 16-inch pizza with the following toppings: 
- pepperoni 


Making a 12-inch pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


注意 ”你 经 常会 看 到 通用 形 参 名 *args， 它 也 收集 任意 数量 的 位 置 实 参 。 
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8.5.2 ”使 用 任意 数量 的 关键 字 实 参 


有 了 时候 , 需要 接受 任意 数量 的 实 参 , 但 预先 不 知道 传递 给 函数 的 会 是 什么 样 的 信息 。 在 这 种 
情况 下 , 可 将 函数 编写 成 能 够 接受 任意 数量 的 键 值 对 一 一 调用 语句 提供 了 多 少 就 接受 多 少 。 一 个 
这 样 的 示例 是 创建 用 户 简介 : 你 知道 将 收 到 有 关 用 户 的 信息 , 但 不 确定 会 是 什么 样 的 信息 。 在 下 
面 的 示例 中 ， 函 数 build_profile() 接 受 名 和 姓 ， 还 接受 任意 数量 的 关键 字 实 参 : 


user profile.py def build profile(first, last, **user info): 
"" "创建 一 个 字典 ， 其 中 包含 我 们 知道 的 有 关 用 户 的 一 切 。""" 
© user info['first name'] = first 
user info['last name'] = last 
return user info 


user profile = build profile('albert', 'einstein', 
location="'princeton’', 
field="'physics') 


print(user profile 


函数 build_profile() 的 定义 要 求 提供 名 和 姓 , 同时 允许 根据 需要 提供 任意 数量 的 名 称 值 对 。 
形 参 fxuser info 中 的 两 个 星 号 让 Python 创建 一 个 名 为 user_info 的 空 字典 ， 并 将 收 到 的 所 有 名 
称 值 对 都 放 到 这 个 字典 中 。 在 这 个 函数 中 ， 可 以 像 访问 其 他 字典 那样 访问 user_info 中 的 名 称 
值 对 。 


在 build_profile() 的 函数 体内 ， 将 名 和 姓 加 入 了 字典 user_info 中 ( 见 @ )， 因 为 总 是 会 从 
用 户 那 里 收 到 这 两 项 信息 ， 而 这 两 项 信息 没有 放 到 这 个 字典 中 。 接 下 来 ， 将 字典 user info 返回 
到 函数 调用 行 。 

我 们 调用 build profile() ， 向 它 传递 名 ( 'albert' )、 姓 ('einstein' ) 和 两 个 键 值 对 
( location='princeton' 和 field='physics' )， 并 将 返回 的 user_info 赋 给 变量 user profile， 再 
打印 该 变量 : 


{'location': 'princeton', 'field': 'physics', 
‘first name': 'albert', 'last name': 'einstein'} 


在 这 里 , 返回 的 字典 包含 用 户 的 名 和 姓 ， 还 有 求学 的 地 方 和 所 学 专业 。 调 用 这 个 函数 时 ， 不 
管 额外 提供 多 少 个 键 值 对 ， 它 都 能 正确 地 处 理 。 


编写 函数 时 ,能 以 各 种 方式 混合 使 用 位 置 实 参 、 关 键 字 实 参 和 任意 数量 的 实 参 。 知 道 这 些 实 
参 类 型 大 有 神 益 ,因为 阅读 别人 编写 的 代码 时 经 常会 见 到 它们 。 要 正确 地 使 用 这 些 类 型 的 实 参 并 
知道 其 使 用 时 机 , 需要 经 过 一 定 的 练习 。 就 目前 而 言 , 牢记 使 用 最 简单 的 方法 来 完成 任务 就 好 了 。 
继续 往 下 阅读 ， 你 就 会 知道 在 各 种 情况 下 哪 种 方法 的 效率 最 高 。 


注意 ”你 经 常会 看 到 形 参 名 **kwargs， 它 用 于 收集 任意 数量 的 关键 字 实 参 。 


动手 试 一 斌 


练习 8-12: 三 明治 ”编写 一 个 函数 ， 它 接受 顾客 要 在 三 明治 中 添加 的 一 系列 食材 。 
这 个 函数 只 有 一 个 形 参 〈 它 收集 函数 调用 中 提供 的 所 有 食材 ) 并 打印 一 条 消息 ， 对 顾 
客 点 的 三 明治 进行 概述 。 调 用 这 个 函数 三 次 ， 每 次 都 提供 不 同 数量 的 实 参 。 

练习 8-13: 用 户 简介 复制 前 面 的 程序 user profilepy， 在 其 中 调用 build profile() 


来 创建 有 关 你 的 简介 。 调 用 这 个 函数 时 ， 指 定 你 的 名 和 姓 ， 以 及 三 个 描述 你 的 键 值 对 。 

练习 8-14: 汽车 “编写 一 个 函数 ， 将 一 辆 汽车 的 信息 存储 在 字典 中 。 这 个 函数 总 是 
接受 制造 商 和 型 号 ， 还 接受 任意 数量 的 关键 字 实 参 。 这 样 调用 该 函数 : 提供 必 不 可 少 的 
信息 , 以 及 两 个 名 称 值 对 , 如 颜色 和 选 装配 件 。 这 个 函数 必须 能 够 像 下 面 这 样 进行 调用 : 


car = make car('subaru', 'outback', color='blue', tow package=True) 


打印 返回 的 字典 ， 确 认 正 确 地 处 理 了 所 有 的 信息 。 


8.6 将 函数 存储 在 模块 中 

使 用 函数 的 优点 之 一 是 可 将 代码 块 与 主 程序 分 离 。 通 过 给 函数 指定 描述 性 名 称 , 可 让 主 程序 
容易 理解 得 多 。 你 还 可 以 更 进一步 , 将 函数 存储 在 称 为 模块 的 独立 文件 中 ，, 再 将 模块 导入 到 主 程 
序 中 。import 语句 允许 在 当前 运行 的 程序 文件 中 使 用 模块 中 的 代码 。 

通过 将 函数 存储 在 独立 的 文件 中 ， 可 隐藏 程序 代码 的 细节 ， 将 重点 放 在 程序 的 高 层 逻 辑 上 。 
这 还 能 让 你 在 众多 不 同 的 程序 中 重用 函数 。 将 函数 存储 在 独立 文件 中 后 ,可 与 其 他 程序 员 共享 这 
些 文件 而 不 是 整个 程序 。 知 道 如 何 导入 函数 还 能 让 你 使 用 其 他 程序 员 编 写 的 函数 库 。 

导入 模块 的 方法 有 多 种 ， 下 面 对 每 种 进行 简要 的 介绍 。 


8.6.1 导入 整个 模块 


要 让 函数 是 可 导入 的 ， 得 先 创建 模块 。 模 块 是 扩展 名 为 .py 的 文件 ,包含 要 导 人 到 程序 中 的 
代码 .下面 来 创建 一 个 包含 函数 make_pizza() 的 模块 .为 此 ,将 文件 pizza.py 中 除 函 数 make_pizza() 
之 外 的 其 他 代码 删除 : 


pizza.py def make pizza(size, *toppings): 
""" 概 述 要 制作 的 比萨 。""" 
print(f"\nMaking a {size}-inch pizza with the following toppings:") 
for topping in toppings: 
print(f"- {topping}") 


接 下 来 ， 在 pizza.py 所 在 的 目录 中 创建 一 个 名 为 making_pizzas.py 的 文件 。 这 个 文件 导入 刚 
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创建 的 模块 ， 再 调用 make_pizza() 两 次 : 


making import pizza 
pizzas.py 
@ pizza.make pizza(16, 'pepperoni') 
pizza.make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


Python 读 取 这 个 文件 时 ,代码 行 import pizza 让 Python 打开 文件 pizza.py， 并 将 其 中 的 所 有 
函数 都 复制 到 这 个 程序 中 。 你 看 不 到 复制 的 代码 ， 因 为 在 这 个 程序 即将 运行 时 ，Python 在 幕后 复 
制 了 这 些 代 码 。 你 只 需 知道 ， 在 making pizzas.py 中 ， 可 使 用 pizza.py 中 定义 的 所 有 函数 。 


要 调用 被 导入 模块 中 的 函数 ， 可 指定 被 导入 模块 的 名 称 pizza 和 了 困 数 名 make_pizza()， 并 用 
句点 分 隔 ( 见 @ )。 这 些 代 码 的 输出 与 没有 导入 模块 的 原始 程序 相同 : 


Making a 16-inch pizza with the following toppings : 
- pepperoni 


Making a 12-inch pizza with the following toppings: 8 


- mushrooms 
- green peppers 
- extra cheese 


这 就 是 一 种 导入 方法 : 只 需 编写 一 条 import 语句 并 在 其 中 指定 模块 名 ， 就 可 在 程序 中 使 用 
该 模块 中 的 所 有 函数 。 如 果 使 用 这 种 import 语句 导入 了 名 为 module_name.py 的 整个 模块 ， 就 可 
使 用 下 面 的 语法 来 使 用 其 中 任何 一 个 函数 : 


module name. function name() 


8.6.2 导入 特定 的 函数 
还 可 以 导入 模块 中 的 特定 函数 ， 这 种 导入 方法 的 语法 如 下 : 


from modUle name import function name 


通过 用 逗号 分 隔 函 数 名 ， 可 根据 需要 从 模块 中 导入 任意 数量 的 函数 : 


from module name import function 0o, function 1, function 2 


对 于 前 面 的 making_pizzas.py 示例 ， 如 果 只 想 导 入 要 使 用 的 函数 ， 代 码 将 类 似 于 下 面 这 样 : 


from pizza import make pizza 


make pizza(16, 'pepperoni') 
make_ pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 
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使 用 这 种 语法 时 ， 调 用 函数 时 无 须 使 用 句点 。 由 于 在 import 语句 中 显 式 地 导 和 人 了 函数 
make_pizza()， 调 用 时 只 需 指定 其 名 称 即 可 。 


8.6.3 使 用 as 给 函数 指定 别名 

如 果 要 导入 函数 的 名 称 可 能 与 程序 中 现 有 的 名 称 冲 突 , 或 者 函数 的 名 称 太 长 , 可 指定 简短 而 
独一无二 的 别名 : 函数 的 另 一 个 名 称 ， 类 似 于 外 号 。 要 给 函数 取 这 种 特殊 外 号 ， 需 要 在 导 人 它 时 
指定 。 

下 面 给 函数 make_pizza() 指 定 了 别名 mp()。 这 是 在 import 语句 中 使 用 make pizza as mp 实 
现 的 ， 关键 字 as 将 函数 重 命名 为 指定 的 别名 : 


from pizza import make pizza as mp 


mp(16, 'pepperoni') 
mp(12, 'mushrooms', 'green peppers', "extTa cheese') 


上 面 的 import 语句 将 函数 make_pizza() 重 命名 为 mp()。 在 这 个 程序 中 ， 每 当 需 要 调用 
make_pizza() 时 ， 都 可 简写 成 mp()。Python 将 运行 make_pizza() 中 的 代码 ， 避 免 与 这 个 程序 可 能 
包含 的 函数 make_pizza() 混 淆 。 

指定 别名 的 通用 语法 如 下 : 


from module name import function name as fn 


8.6.4 使 用 as 给 模块 指定 别名 
还 可 以 给 模块 指定 别名 。 通过 给 模块 指定 简短 的 别名 ( 如 给 模块 pizza 指定 别名 p ), 让 你 能 
够 更 轻松 地 调用 模块 中 的 防 数 。 相 比 于 pizza.make_pizza()，p.make_pizza() 更 为 简洁 : 


import pizza as p 


p.make pizza(16, 'pepperoni') 
p.make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


上 述 import 语句 给 模块 pizza 指定 了 别名 p, 但 该 模块 中 所 有 函数 的 名 称 都 没 变 。 要 调用 函 
数 make_pizza()， 可 编写 代码 p.make pizza() 而 非 pizza.make _pizza()。 这 样 不 仅 代码 更 简洁 ， 
还 让 你 不 用 再 关注 模块 名 ， 只 专注 于 描述 性 的 函数 名 。 这 些 函 数 名 明确 指出 了 表 数 的 功能 ， 对 于 
理解 代码 而 言 ， 比 模块 名 更 重要 。 


给 模块 指定 别名 的 通用 语法 如 下 : 


import moOdUlLe name as mn 
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8.6.5 “导入 模块 中 的 所 有 函数 
使 用 星 号 (* ) 运算 符 可 让 Python 导入 模块 中 的 所 有 函数 : 


from pizza import * 


make_ pizza(16, 'pepperoni') 
make_ pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


import 语句 中 的 星 号 让 Python 将 模块 pizza 中 的 每 个 函数 都 复制 到 这 个 程序 文件 中 。 由 于 导 
和 人 了 每 个 函数 ， 可 通过 名 称 来 调用 每 个 函数 ， 而 无 须 使 用 句点 表示 法 。 然 而 ,使 用 并 非 自 己 编写 
的 大 型 模块 时 , 最 好 不 要 采用 这 种 导入 方法 。 这 是 因为 如 果 模 块 中 有 函数 的 名 称 与 当前 项 目 中 使 
用 的 名 称 相同 ， 可 能 导致 意 想不到 的 结果 : Python 可 能 遇 到 多 个 名 称 相同 的 函数 或 变量 ,进而 覆 
六 函数 ， 而 不 是 分 别 导入 所 有 的 也 数 。 

最 佳 的 做 法 是 , 要 么 只 导入 需要 使 用 的 函数 ,要 么 导入 整个 模块 并 使 用 句点 表示 法 。 这 让 代 
码 更 清晰 ， 更 容易 阅读 和 理解 。 这 里 之 所 以 介绍 这 种 导入 方法 ,只 是 想 让 你 在 阅读 别人 编写 的 代 
码 时 ， 能 够 理解 类 似 于 下 面 的 import 语句 : 


from module name import * 


8.7 ”函数 编写 指南 

编写 函数 时 ， 需 要 牢记 几 个 细节 。 应 给 函数 指定 描述 性 名 称 ， 且 只 在 其 中 使 用 小 写字 母 和 下 
划 线 。 描 述 性 名 称 可 帮助 你 和 别人 明白 代码 想 要 做 什么 。 给 模块 命名 时 也 应 遵循 上 述 约定 。 

每 个 函数 都 应 包含 简要 地 阐述 其 功能 的 注释 。 该 注释 应 紧 跟 在 函数 定义 后 面 , 并 采用 文档 字 
符 串 格式 。 文 档 良 好 的 函数 让 其 他 程序 员 只 需 阅 读 文档 字符 串 中 的 描述 就 能 够 使 用 它 。 他 们 完全 
可 以 相信 代码 如 描述 的 那样 运行 ,并且 只 要 知道 函数 的 名 称 、 需 要 的 实 参 以 及 返回 值 的 类 型 ,就 
能 在 自己 的 程序 中 使 用 它 。 

给 形 参 指定 默认 值 时 ， 等 号 两 边 不 要 有 空格 : 


def function name(parameter 0, parameter 1="' default value') 


对 于 函数 调用 中 的 关键 字 实 参 ， 也 应 遵循 这 种 约定 : 


function name( valye 0, parameter 1=" Valuye') 


PEP 8 建议 代码 行 的 长 度 不 要 超过 79 字符 ， 这 样 只 要 编辑 器 窗口 适中 ， 就 能 看 到 整 行 代码 。 
如 果 形 参 很 多 ， 导 致 函数 定义 的 长 度 超过 了 79 字符 ， 可 在 函数 定义 中 输入 左 括号 后 按 回 车 键 ， 
并 在 下 一 行 按 两 次 Tab 键 ， 从 而 将 形 参 列表 和 只 缩 进 一 层 的 函数 体 区 分 开 来 。 
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大 多 数 编辑 器 会 自动 对 齐 后 续 参 数列 表 行 , 使 其 缩 进程 度 与 你 给 第 一 个 参数 列表 行 指定 的 缩 
进程 度 相 同 : 


def function name( 
parameter 0, parameter 1, parameter 2, 
parameter 3, parameter 4, parameter 5): 
function body... 


如 果 程 序 或 模块 包含 多 个 函数 , 可 使 用 两 个 空 行将 相 邻 的 函数 分 开 , 这 样 将 更 容易 知道 前 一 
个 函数 在 什么 地 方 结束 ， 下 一 个 函数 从 什么 地 方 开始 。 

所 有 import 语句 都 应 放 在 文件 开头 。 唯 一 例外 的 情形 是 ， 在 文件 开头 使 用 了 注释 来 描述 整 
个 程序 。 


动手 试 一 斌 
练习 8-15: 打印 模型 ”将 示例 printing models.py 中 的 函数 放 在 一 个 名 为 printing 
functions.py 的 文件 中 。 在 printing models.py 的 开头 编写 一 条 import 语句 ， 并 修改 该 文 
件 以 使 用 导入 的 函数 。 
练习 8-16: 导入 ”选择 一 个 你 编写 的 且 只 包含 一 个 函数 的 程序 ， 将 该 函数 放 在 另 一 
个 文件 中 。 在 主 程序 文件 中 ， 使 用 下 述 各 种 方法 导入 这 个 函数 ， 再 调用 它 : 


import VOLe name 

from modu/le name import function name 

from module name import function name as fn 
import module name as mn 

from module name import * 


练习 8-17: 函数 编写 指南 ”选择 你 在 本 章 中 编写 的 三 个 程序 ， 确 保 它 们 遵循 了 本 节 
介绍 的 函数 编写 指南 。 


8.8 小 结 


在 本 章 中 ,你 学 习 了 : 如 何 编写 函数 ， 以 及 如 何 传递 实 参 ,， 让 函数 能 够 访问 完成 其 工作 所 需 
的 信息 ; 如 何 使 用 位 置 实 参 和 关键 字 实 参 ， 以 及 如 何 接受 任意 数量 的 实 参 ; 显示 输出 的 函数 和 返 
回 值 的 函数 ; 如 何 将 函数 同 列表 、 字 典 、if 语句 和 while 循环 结合 起 来 使 用 ; 如 何 将 函数 存储 在 
称 为 模块 的 独立 文件 中 ， 让 程序 文件 更 简单 、 更 易于 理解 。 最 后 ， 你 学 习 了 函数 编写 指南 ， 遵 循 
这 些 指南 可 让 程序 始终 结构 良好 ， 并 对 你 和 其 他 人 来 说 易于 阅读 。 
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程序 员 的 目标 之 一 是 , 编写 简单 的 代码 来 完成 任务 ,而 函数 有 助 于 你 实现 这 样 的 目标 。 它 们 
让 你 编写 好 代码 块 并 确定 其 能 够 正确 运行 后 ,就 可 置之不理 ,确定 函数 能 够 正确 地 完成 其 工作 后 ， 
你 就 可 以 接着 投身 于 下 一 个 编码 任务 。 

函数 让 你 编写 代码 一 次 后 , 想 重用 它们 多 少 次 就 重用 多 少 次 。 需 要 运行 函数 中 的 代码 时 ,只 
需 编 写 一 行 函数 调用 代码 ,就 可 让 函数 完成 其 工作 。 需 要 修改 函数 的 行为 时 ， 只 需 修改 一 个 代码 
块 ， 而 所 做 的 修改 将 影响 调用 这 个 函数 的 每 个 地 方 。 


使 用 函数 让 程序 更 容易 阅读 , 而 良好 的 函数 名 概述 了 程序 各 个 部 分 的 作用 。 相 对 于 阅读 一 系 
列 的 代码 块 ， 阅 读 一 系列 函数 调用 让 你 能 够 更 快 地 明白 程序 的 作用 。 


函数 还 让 代码 更 容易 测试 和 调试 。 如 果 程 序 使 用 一 系列 的 函数 来 完成 其 任务 , 而 其 中 的 每 个 
函数 都 完成 一 项 具体 的 工作 , 测试 和 维护 起 来 将 容易 得 多 : 可 编写 分 别 调用 每 个 函数 的 程序 ， 并 
测试 每 个 函数 是 否 在 它 可 能 遇 到 的 各 种 情形 下 都 能 正确 地 运行 。 经 过 这 样 的 测试 后 你 就 能 充满 信 
心 ， 深 信 每 次 调用 这 些 函数 时 ， 它 们 都 将 正确 地 运行 。 

在 第 9 章 , 你 将 学 习 编 写 类 。 类 将 函数 和 数据 整洁 地 封装 起 来 ,让 你 能 够 灵活 而 高 效 地 使 用 
它们 。 
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类 


面向 对 象 编程 是 最 有 效 的 软件 编写 方法 之 一 。 在 面向 对 象 编程 
中 , 你 编写 表示 现实 世界 中 的 事物 和 情景 的 类 , 并 基于 这 些 类 来 创建 
对 象 。 编 写 类 时 ， 你 定义 一 大 类 对 象 都 有 的 通用 行为 。 基 于 类 创建 
对 象 时 , 每 个 对 象 都 自动 具备 这 种 通用 行为 ,然后 可 根据 需要 赋予 每 
个 对 象 独特 的 个 性 。 使 用 面向 对 象 编 程 可 模拟 现实 情景 ， 其 逼真 程度 
达到 了 令 人 惊讶 的 地 步 。 


根据 类 来 创建 对 象 称 为 实例 化 , 这 让 你 能 够 使 用 类 的 实例 。 在 本 

章 中 , 你 将 编写 一 些 类 并 创建 其 实例 。 你 将 指定 可 在 实例 中 存储 什么 

言 息 ， 定 义 可 对 这 些 实例 执行 哪些 操作 。 你 还 将 编写 一 些 类 来 扩展 既 有 类 的 功能 ， 让 相似 的 

类 能 够 高 效 地 共享 代码 。 你 将 把 自己 编写 的 类 存储 在 模块 中 , 并 在 自己 的 程序 文件 中 导入 其 
他 程序 员 编 写 的 类 。 

理解 面向 对 象 编程 有 助 于 你 像 程序 员 那 样 看 世界 ,还 可 以 帮助 你 真正 明白 自己 编写 的 代 
码 ; 不 仅 是 各 行 代码 的 作用 ,还 有 代码 背后 更 宏大 的 概念 。 了 解 类 背后 的 概念 可 培养 逻辑 思 
维 ， 让 你 能 够 通过 编写 程序 来 解决 遇 到 的 几乎 任何 问题 。 

随 着 面临 的 挑战 上 日益 严峻 ， 类 还 能 让 你 以 及 与 你 合作 的 其 他 程序 员 的 生活 更 轻松 。 如 果 
你 与 其 他 程序 员 基 于 同样 的 逻辑 来 编写 代码 ,你 们 就 能 明白 对 方 所 做 的 工作 。 你 编写 的 程序 
将 能 被 众多 合作 者 所 理解 ， 每 个 人 都 能 事半功倍 。 ; 

这 
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使 用 类 几乎 可 以 模拟 任何 东西 。 下 面 来 编写 一 个 表示 小 狗 的 简单 类 Dog， 它 表示 的 不 是 特定 
的 小 狗 ， 而 是 任何 小 狗 。 对 于 大 多 数 宠物 狗 ， 我 们 都 知道 些 什么 呢 ? 它们 都 有 名 字 和 年 龄 。 我 们 
还 知道 ,大 多 数 小 狗 还 会 足下 和 打滚 。 由 于 大 多 数 小 狗 都 具备 上 述 两 项 信息 (名字 和 年 龄 ) 和 两 
种 行为 ( 蹲 下 和 打滚 )， 我 们 的 Dog 类 将 包含 它们 。 这 个 类 让 Python 知道 如 何 创建 表示 小 狗 的 对 
象 。 编 写 这 个 类 后 ， 我 们 将 使 用 它 来 创建 表示 特定 小 狗 的 实例 。 
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9.1.1 创建 Dog 类 


根据 Dog 类 创建 的 每 个 实例 都 将 存储 名 字 和 年 龄 ， 我 们 赋予 了 每 条 小 狗 蹲 下 (sit() ) 和 打 
深 (roll over() ) 的 能 


dog.py ®@ class Dog: 
@ """ 一 次 模拟 小 狗 的 简单 尝试 。""" 


(3 def _init (self, name, age): 
"" "初始 化 属性 name 和 age。""" 
@ self.name = name 


self.age = age 


(5) def sit(self): 
"" "模拟 小 狗 收 到 命令 时 足下。""" 
print(f"{self.name} is now sitting.") 


def roll over(self): 
"" "模拟 小 狗 收 到 命令 时 打滚 。 nn 
print(f"{self.name} rolled over!") 


这 里 需要 注意 的 地 方 很 多 , 但 也 不 用 担心 , 本 章 充 斥 着 这 样 的 结构 , 你 有 大 把 的 机 会 熟悉 它 。 
@ 处 定义 了 一 个 名 为 Dog 的 类 。 根 据 约定 ,在 Python 中 ， 首 字母 大 写 的 名 称 指 的 是 类 。 这 个 类 定 
义 中 没有 圆 括号 ， 因 为 要 从 空白 创建 这 个 类 。@@ 处 编写 了 一 个 文档 字符 串 ， 对 这 个 类 的 功能 做 了 
描述 。 


方法 _ init_() 

类 中 的 孔 数 称 为 方法 。 你 在 前 面 学 到 的 有 关 水 数 的 一 切 都 适用 于 方法 ， 就 目前 而 言 ， 唯 一 
重要 的 差别 是 调用 方法 的 方式 。@ 处 的 方法 _init () 是 一 个 特殊 方法 , 每 当 你 根据 Dog 类 创建 
新 实例 时 ，Python 都 会 自动 运行 它 。 在 这 个 方法 的 名 称 中 ,开头 和 末尾 各 有 两 个 下 划 线 ， 这 是 
一 种 约定 ， 骨 在 避免 Python 默认 方法 与 普通 方法 发 生 名 称 冲突 。 务 必 确 保 _init () 的 两 边 都 
有 两 个 下 划 线 ， 否 则 当 你 使 用 类 来 创建 实例 时 ， 将 不 会 自动 调用 这 个 方法 ， 进 而 引发 难以 发 现 
的 错误 。 

我 们 将 方法 _init () 定 义 成 包含 三 个 形 参 : self、name 和 age。 在 这 个 方法 的 定义 中 ， 形 
参 self 必 不 可 少 ， 而 且 必须 位 于 其 他 形 参 的 前 面 。 为 何必 须 在 方法 定义 中 包含 形 参 self 呢 ? 
为 Python 调用 这 个 方法 来 创建 Dog 实例 时 ， 将 自动 传人 实 参 self。 每 个 与 实例 相关 联 的 方法 调 
用 都 自动 传递 实 参 self, 它 是 一 个 指向 实例 本 身 的 引用 , 让 实例 能 够 访问 类 中 的 属性 和 方法 。 创 
建 Dog 实例 时 ，Python 将 调用 Dog 类 的 方法 _init_()。 我 们 将 通过 实 参 向 Dog() 传 递 名 字 和 年 
龄 ，self 会 自动 传递 ,因此 不 需要 传递 它 。 每 当 根 据 Dog 类 创建 实例 时 ， 都 只 需 给 最 后 两 个 形 参 
(name 和 age ) 提供 值 。 


@ 处 定义 的 两 个 变量 都 有 前 级 self。 以 self 为 前 绥 的 变量 可 供 类 中 的 所 有 方法 使 用 ， 可 以 
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通过 类 的 任何 实例 来 访问 。 self.name = name 获取 与 形 参 name 相关 联 的 值 , 并 将 其 赋 给 变量 name， 
然后 该 变量 被 关联 到 当前 创建 的 实例 。self.age = age 的 作用 与 此 类 似 。 像 这 样 可 通过 实例 访问 
的 变量 称 为 属性 。 


Dog 类 还 定义 了 另外 两 个 方法 : sit() 和 roll over() ( 见 @ )。 这 些 方法 执行 时 不 需要 额外 的 
言 息 ， 因 此 它们 只 有 一 个 形 参 self。 我们 随后 将 创建 的 实例 能 够 访问 这 些 方法 , 换 句 话说 , 它们 
都 会 足下 和 打滚 。 当 前 ，sit() 和 roll_over() 所 做 的 有 限 ， 只 是 打印 一 条 消息 ， 指 出 小 狗 正在 蹲 
下 或 打滚 。 但 可 以 扩展 这 些 方法 以 模拟 实际 情况 : 如 果 这 个 类 包含 在 一 个 计算 机 游戏 中 ,这 些 方 
法 将 包含 创建 小 狗 蹲 下 和 打滚 动画 效果 的 代码 ; 如 果 这 个 类 是 用 于 控制 机 器 狗 的 , 这 些 方法 将 让 
机 需 狗 做 出 足下 和 打滚 的 动作 。 


9.1.2 根据 类 创建 实例 


可 将 类 视 为 有 关 如 何 创建 实例 的 说 明 。Dog 类 是 一 系列 说 明 , 让 Python 知道 如 何 创建 表示 特 
定 小 狗 的 实例 。 


下 面 来 创建 一 个 表示 特定 小 狗 的 实例 : 


class Dog: 
-- SNip-- 


@ my dog = Dog('Willie', 6) 


@ print(f"My dog's name is {my dog.name}.") 
@ print(f"My dog is {my dog.age} years ol1d.") 


在 这 里 使 用 的 是 前 一 个 示例 中 编写 的 Dog 类 。 在 @ 处 ， 让 Python 创建 一 条 名 字 为 'Willie'、 
年 龄 为 6 的 小 狗 。 遇 到 这 行 代码 时 ，Python 使 用 实 参 'Willie' 和 6 调用 Dog 类 的 方法 _init ()。 
方法 _init_() 创 建 一 个 表示 特定 小 狗 的 实例 , 并 使 用 提供 的 值 来 设置 属性 name 和 age。 接 下 来 ， 
Python 返回 一 个 表示 这 条 小 狗 的 实例 ,而 我 们 将 这 个 实例 赋 给 了 变量 my_dog。 在 这 里 , 命名 约定 
很 有 用 : 通常 可 认为 首 字母 大 写 的 名 称 ( 如 Dog ) 指 的 是 类 ， 而 小 写 的 名 称 ( 如 my_dog ) 指 的 是 
根据 类 创建 的 实例 。 


1. 访问 属性 
要 访问 实例 的 属性 , 可 使 用 句点 表示 法 。 @ 处 编写 了 如 下 代码 来 访问 my_dog 的 属性 name 的 值 : 


my_dog.name 


句点 表示 法 在 Python 中 很 常用 , 这 种 语法 演示 了 Python 如 何 获悉 属性 的 值 。 在 这 里 ，Python 
先 找 到 实例 my_dog, 再 查找 与 该 实例 相关 联 的 属性 name。 在 Dog 类 中 引用 这 个 属性 时 , 使 用 的 是 
self.name。 在 上 处 ， 使 用 同样 的 方法 来 获取 属性 age 的 值 。 
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输出 是 有 关 my_dog 的 摘要 : 


My dog's name is Willie. 
My dog is 6 years old. 


2. 调用 方法 


根据 Dog 类 创建 实例 后 ,就 能 使 用 句点 表示 法 来 调用 Dog 类 中 定义 的 任何 方法 了 。 下 面 来 让 


小 狗 蹲 下 和 打滚: 


class Dog: 
-=-SNnip-- 


my dog = Dog('Willie', 6) 
my_dog.sit() 
my_dog.roll over() 


要 调用 方法 ,可 指定 实例 的 名 称 ( 这 里 是 my_dog ) 和 要 调用 的 方法 ， 并 用 句点 分 隔 。 遇 到 代 
码 my dog.sit() 时 ，Python 在 类 Dog 中 查找 方法 sit() 并 运行 其 代码 。Python 以 同样 的 方式 解读 


代码 my dog.roll over()。 
Willie 按 我 们 的 命令 做 了 : 


Willie is now sitting. 
Willie rolled over! 


这 种 语法 很 有 用 。 如 果 给 属性 和 方法 指定 了 合适 的 描述 性 名 称 ， 如 name 、age、 
roll_over()， 即 便 是 从 未 见 过 的 代码 块 ， 我 们 也 能 够 轻松 地 推断 出 它 是 做 什么 的 。 


3. 创建 多 个 实例 
可 按 需 求 根 据 类 创建 任意 数量 的 实例 。 下 面 再 创建 一 个 名 为 your_dog 的 小 狗 实 例 : 


sit() 和 


class Dog: 
-- Snip-- 


my_dog = Dog('Willie', 6) 
your dog = Dog('Lucy', 3) 


print(f"My dog's name is {my _dog.name}.") 
print(f"My dog is {my dog.age} years old.") 
my_dog.sit() 


print(f"\nYour dog's name is {your dog.name}.") 
print(f"Your dog is {your dog.age} years ol1d.") 
your dog.sit() 
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在 本 例 中 创建 了 两 条 小 狗 ， 分 别名 为 Willie 和 Lucy。 每 条 小 狗 都 是 一 个 独立 的 实例 ， 有 自 
己 的 一 组 属性 ， 能 够 执行 相同 的 操作 : 


My dog's name is Willie. 
My dog is 6 years old. 
Willie is now sitting. 


Your dog's name is Lucy. 
Your dog is 3 years old. 
Lucy is now sitting. 


即使 给 第 二 条 小 狗 指定 同样 的 名 字 和 年 龄 ，Python 依然 会 根据 Dog 类 创建 另 一 个 实例 。 你 可 
按 需 求 根据 一 个 类 创建 任意 数量 的 实例 , 条 件 是 将 每 个 实例 都 存储 在 不 同 的 变量 中 , 或 者 占用 列 
表 或 字典 的 不 同位 置 。 


动手 试 一 斌 
练习 9-1: 餐馆 创建 一 个 名 为 Restaurant 的 类 ， 为 其 方法 init () 设 置 属性 
restaurant name 和 cuisine type。 创 建 一 个 名 为 describe restaurant() 的 方法 和 一 个 
名 为 open restaurant() 的 方法 ， 前 者 打印 前 述 两 项 信息 ， 而 后 者 打印 一 条 消息 ， 指 出 
餐馆 正在 营业 。 
根据 这 个 类 创建 一 个 名 为 restaurant 的 实例 ， 分 别 打印 其 两 个 属性 ， 再 调用 前 述 
两 个 方法 。 


练习 9-2: 三 家 餐馆 根据 为 完成 练习 9-1 而 编写 的 类 创建 三 个 实例 ， 并 对 每 个 实 
例 调 用 方法 describe restaurant()。 
练习 9-3: 用 户 ”创建 一 个 名 为 User 的 类 ， 其 中 包含 属性 first name 和 1ast name， 
以 及 用 户 简 介 通 常会 存储 的 其 他 几 个 属性 。 二 User 中 定义 一 个 名 为 describe user() 
的 方法 ， 用 于 打印 用 户 信息 摘要 。 再 定义 一 个 名 为 greet user() 的 方法 ， 用 于 向 用 户 发 
出 个 性 化 的 问候 。 
创建 多 个 表示 不 同 用 户 的 实例 ， 并 对 每 个 实例 调用 上 述 两 个 方法 。 


9.2 ”使 用 类 和 实例 


可 使 用 类 来 模拟 现实 世界 中 的 很 多 情景 。 类 编写 好 后 , 你 的 大 部 分 时 间 将 花 在 根据 类 创建 的 
实例 上 。 你 需要 执行 的 一 个 重要 任务 是 修改 实例 的 属性 。 可 以 直接 修改 实例 的 属性 ,也 可 以 编写 
方法 以 特定 的 方式 进行 修改 。 
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9.2.1 Car 类 
下 面 来 编写 一 个 表示 汽车 的 类 。 它 存储 了 有 关 汽 车 的 信息 ， 还 有 一 个 汇总 这 些 信 息 的 方法 : 


carpy Class Car: 
""" 一 次 模拟 汽车 的 简单 尝试 。 nn 


© def _init (self, make, model, year): 
""" 初 始 化 描述 汽车 的 属性 。""" 
self.make = make 
self.model = model 
self.year = year 


© def get descriptive name(self): 
"" "返回 整洁 的 描述 性 信息 。""" 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 
@ my new car = Car('audi', 'a4', 2019) 
print(my new car.get descriptive name()) 


在 @ 处 ,定义 了 方法 _init _()。 与 前 面 的 Dog 类 中 一 样 ， 这 个 方法 的 第 一 个 形 参 为 self。 
该 方法 还 包含 另外 三 个 形 参 : make、model 和 year。 方 法” init () 接 受 这 些 形 参 的 值 ， 并 将 
它们 赋 给 根据 这 个 类 创建 的 实例 的 属性 。 创 建新 的 Car 实例 时 , 需要 指定 其 制造 商 、 型 号 和 生产 
年 份 。 

在 @ 处 ， 定 义 了 一 个 名 为 get descriptive_name() 的 方法 。 它 使 用 属性 year 、make 和 model 
创建 一 个 对 汽车 进行 描述 的 字符 串 , 让 我 们 无 须 分 别 打 印 每 个 属性 的 值 。 为 在 这 个 方法 中 访问 属 
性 的 值 ， 使 用 了 self.make 、self.model 和 self.year。 在 目 处 ， 根 据 Car 类 创建 了 一 个 实例 ， 并 
将 其 赋 给 变量 my_new_car。 接 下 来 ， 调 用 方法 get_ descriptive_name()， 指 出 我 们 拥有 一 辆 什么 
样 的 汽车 : 


2019 Audi A4 


为 了 让 这 个 类 更 有 趣 ， 下 面 给 它 添加 一 个 随时 间 变 化 的 属性 ， 用 于 存储 汽车 的 总 里 程 。 


9.2.2 ”给 属性 指定 默认 值 

创建 实例 时 ， 有 些 属性 无 须 通 过 形 参 来 定义 ， 可 在 方法 _init () 中 为 其 指定 默认 值 。 

下 面 来 添加 一 个 名 为 odometer reading 的 属性 ,其 初始 值 总 是 为 0。 我 们 还 添加 了 一 个 名 为 
read_odometer() 的 方法 ， 用 于 读 取 汽车 的 里 程 表 : 


class Car: 


def init (self, make, model, year): 
"" "初始 化 描述 汽车 的 属性 。""" 
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self.make = make 
self.model = model 
self.year = year 

@ self.odometer reading = 0 


def get descriptive name(self): 
-- SNnip-- 
@ def read odometer(self) 
""" 打 印 一 条 指出 汽车 里 程 的 消息 。"" 
print(f"This car has {self.odometer reading} miles on it.") 


my new car = Car('audi', 'a4', 2019) 
print(my new car.get descriptive name()) 
my_new car.read odometer() 


现在 , 当 Python 调用 方法 _init () 来 创建 新 实例 时 , 将 像 前 一 个 示例 一 样 以 属性 的 方式 存 
储 制造 商 、 型 号 和 生产 年 份 。 接 下 来 ,Python 将 创建 一 个 名 为 odometer reading 的 属性 ,并 将 其 
初始 值 设置 为 0 ( 见 @ )。 在 @ 处 ， 定义 一 个 名 为 read_odometer() 的 方法 ， 让 你 能 够 轻松 地 获悉 
汽车 的 里 程 "。 


一 开始 汽车 的 里 程 为 0: 


2019 Audi A4 
This car has 0 miles on it. 


出 售 时 里 程 表 读 数 为 0 的 汽车 不 多 ， 因 此 需要 一 种 方式 来 修改 该 属性 的 值 。 


9.2.3 ”修改 属性 的 值 

我 们 能 以 三 种 方式 修改 属性 的 值 : 直接 通过 实例 进行 修改 , 通过 方法 进行 设置 ， 以 及 通过 方 
法 进行 递增 ( 增加 特定 的 值 )。 下 面 依次 介绍 这 些 方式 。 

1. 直接 修改 属性 的 值 


要 修改 属性 的 值 , 最 简单 的 方式 是 通过 实例 直接 访问 它 。 下面 的 代码 直接 将 里 程 表 读数 设置 
为 23: 


class Car: 
-- Snip-- 


my new car = Car('audi', 'a4', 2019) 
print(my new car.get descriptive name()) 


@ my new car.odometer reading = 23 
my_new_car.read odometer() 


Q@ 此 处 里 程 的 单位 为 英里 ( mile ) ，1 英里 = 1.6 千 米 。 一 一 编者 注 
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在 @ 处 , 使 用 句点 表示 法 直接 访问 并 设置 汽车 的 属性 odometer_reading。 这 行 代码 让 Python 
在 实例 my_new_car 中 找到 属性 odometer reading， 并 将 其 值 设置 为 23: 


2019 Audi A4 
This car has 23 miles on it. 


l 


有 时 候 需 要 像 这 样 直接 访问 属性 ， 但 其 他 时 候 需 要 编写 对 

2. 通过 方法 修改 属性 的 值 

如 果 有 方法 能 蔡 你 更 新 属性 , 将 大 有 神 益 。 这 样 就 无 须 直 接 访 问 属性 , 而 可 将 值 传递 给 方法 ， 
由 它 在 内 部 进行 更 新 。 

下 面 的 示例 演示 了 一 个 名 为 update_odometer() 的 方法 : 


时 性 进行 更 新 的 方法 。 


| 
dl 


classrCar.: 
-- SNip-- 


@ def update odometer(self, mileage) 
""" 将 里 程 表 读数 设置 为 指定 的 值 。""" 
self.odometer reading = mileage 


my new car = Car('audi', 'a4', 2019) 
print(my new car.get descriptive name()) 


@ my new car.update odometer(23) 
my_new car.read odometer() 


对 Car 类 所 做 的 唯一 修改 是 在 @ 处 添加 了 方法 update_odometer()。 这 个 方法 接受 一 个 里 程 
值 ， 并 将 其 赋 给 self.odometer reading。 在 @ 处 ,调用 update_ odometer()， 并 向 它 提供 了 实 参 
23( 该 实 参 对 应 于 方法 定义 中 的 形 参 mileage ), 它 将 里 程 表 读 数 设 置 为 23 ,而 方法 read_odometer() 
打印 该 读数 : 


2019 Audi A4 
This car has 23 miles on it. 


可 对 方法 update_odometer() 进 行 扩展 ， 使 其 在 修改 里 程 表 读 数 时 做 些 额外 的 工作 。 下 面 来 
添加 一 些 逻 辑 ， 禁 止 任 何人 将 里 程 表 读 数 入 回调: 


class Car: 
-- Snip-- 


def update odometer(self, mileage): 


将 里 程 表 读数 设置 为 指定 的 值 。 
禁止 将 里 程 表 读数 往 回调 。 
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© 


if mileage >= self.odometer reading: 
self.odometer reading = mileage 

else: 
print("You can't roll back an odometer!") 


现在 ，update_odometer() 在 修改 属性 前 检查 指定 的 读数 是 否 合理 。 如 果 新 指定 的 里 程 


(mileage ) 大 于 或 等 于 原来 的 里 程 ( self.odometer reading )， 就 将 里 程 表 读数 改 为 新 指定 的 里 


程 ( 见 @ ); 否则 发 出 警告 ， 指 出 不 能 将 里 程 表 往 回调 〈 见 @ )。 


3. 通过 方法 对 属性 的 值 进 行 递 增 
有 时 候 需要 将 属性 值 递增 特定 的 量 ， 而 不 是 将 其 设置 为 全 新 的 值 。 假 设 我 们 购买 了 一 辆 二 了 


| 


车 ， 且 从 购买 到 登记 期 间 增加 了 100 英里 的 里 程 。 下 面 的 方法 让 我 们 能 够 传递 这 个 增 量 ， 并 相应 
地 增 大 里 程 表 读数 : 


class Car: 
-- Snip-- 


def update odometer(self, mileage): 
-- Snip-- 


def increment odometer(self, miles): 
mn 将 里 程 表 读数 增加 指定 的 量 。""" 
self.odometer reading += miles 


my_used car = Car('subaru', 'outback', 2015) 
print(my_used car.get descriptive name()) 


my_used car.update odometer(23 500) 
my_used car.read odometer() 


my_used car.increment odometer(100) 
my_used car.read odometer() 


在 @ 人 处 ， 新 增 的 方法 increment_odometer() 接 受 一 个 单位 为 英里 的 数 ， 并 将 其 加 入 self. 


odometer reading 中 。 在 @ 处 ,创建 一 辆 二 手 车 my_used_car。 在 四 处 ,调用 方法 update odometer() 
并 传人 23_500， 将 这 辆 二 手 车 的 里 程 表 读 数 设置 为 23 300。 在 @ 处 ， 调 用 increment_odometer() 
并 传人 100， 以 增加 从 购买 到 登记 期 间 行 驶 的 100 英里 : 


2015 Subaru Outback 
This car has 23500 miles on it. 
This car has 23600 miles on it. 


你 可 以 轻松 地 修改 这 个 方法 ， 以 禁止 增 量 为 负 值 ， 从 而 防止 有 人 利用 它 来 回调 里 程 表 。 
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注 


谢 


你 可 以 使 用 类 似 于 上 面 的 方法 来 控制 用 户 修改 属性 值 (如 里 程 表 读数 ) 的 方式 ， 但 能 够 
访问 程序 的 人 都 可 以 通过 直接 访问 属性 来 将 里 程 表 修改 为 任何 值 。 要 确保 安全 ， 除 了 进 
行 类 似 于 前 面 的 基本 检查 外 ， 还 需 特别 注意 细节 。 


本 

练习 9-4: 就 餐 人 数 ”在 为 完成 练习 9-1 而 编写 的 程序 中 ， 添 加 一 个 名 为 numbeT 
served 的 属性 ， 并 将 其 默认 值 设 置 为 0。 根据 这 个 类 创建 一 个 名 为 restaurant 的 实例 。 
打印 有 多 少 人 在 这 家 餐馆 就 餐 过 ， 然 后 修改 这 个 值 并 再 次 打印 它 。 

添加 一 个 名 为 set_number served() 的 方法 ， 让 你 能 够 设置 就 餐 人 数 。 调 用 这 个 方 
法 并 向 它 传 递 一 个 值 ， 然 后 再 次 打印 这 个 值 。 


添加 一 个 名 为 increment number served() 的 方法 ， 让 你 能 够 将 就 餐 人 数 递 增 。 调 


用 这 个 方法 并 向 它 传 递 一 个 这 样 的 值 : 你 认为 这 家 餐馆 每 天 可 能 接待 的 就 餐 人 数 。 

练习 9-$: 尝试 登录 次 数 ”在 为 完成 练习 9-3 而 编写 的 User 类 中 ， 添 加 一 个 名 为 
login attempts 的 属性 。 编 写 一 个 名 为 increment login attempts() 的 方法 ， 将 属性 
login attempts 的 值 加 1。 再 编写 一 个 名 为 reset login _ attempts() 的 方法 ， 将 属性 
login attempts 的 值 重 置 为 0。 

根据 User 类 创建 一 个 实例 ,再 调用 方法 increment login attempts() 多 次 。 打印 属 
性 login attempts 的 值 ,确认 它 被 正确 地 递增 ,然后 ,调用 方法 reset login attempts()， 
并 再 次 打印 属性 login attempts 的 值 ， 确 认 它 被 重 置 为 0。 


9.3 继承 


编写 类 时 , 并非 总 是 要 从 空白 开始 。 如 果 要 编写 的 类 是 男 一 个 现成 类 的 特殊 版 本 , 可 使 用 继 
承 。 一 个 类 继承 另 一 个 类 时 ,将 自动 获得 另 一 个 类 的 所 有 属性 和 方法 。 原 有 的 类 称 为 父 类 ， 而 新 
类 称 为 子 类 。 子 类 继承 了 父 类 的 所 有 属性 和 方法 ， 同 时 还 可 以 定义 自己 的 属性 和 方法 。 


9.3.1 子 类 的 方法 _init__() 
在 既 有 类 的 基础 上 编写 新 类 时 ， 通 常 要 调用 父 类 的 方法 _init_()。 这 将 初始 化 在 父 类 
_init _() 方 法 中 定义 的 所 有 属性 ， 从 而 让 子 类 包含 这 些 属性 。 
例如 ,下面 来 模拟 电动 汽车 。 电 动 汽 车 是 一 种 特殊 的 汽车 ,因此 可 在 前 面 创 建 的 Car 类 的 基 
础 上 创建 新 类 ElectricCar。 这 样 就 只 需 为 电动 汽车 特有 的 属性 和 行为 编写 代码 。 
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下 面 来 创建 ElectricCar 类 的 一 个 简单 版 本 ， 它 具备 Car 类 的 所 有 功能 : 


eleciric ”加 class Car: 
carpy """ 一 次 模拟 汽车 的 简单 党 试 。""" 


def init (self, make, model, year): 
self.make = make 
self.model = model 
self.year = year 
self.odometer reading = 0 


def get descriptive name(self): 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 


def read odometer(self): 
print(f"This car has {self.odometer reading} miles on it.") 


def update odometer(self, mileage): 
if mileage >= self.odometer Teading: 
self.odometer reading = mileage 
else: 
print("You can't roll back an odometer!") 


def increment odometer(self, miles): 
self.odometer reading += miles 


@ class ElectricCar(Car): 
""" 电 动 汽 车 的 独特 之 处 。""" 


【3) def _init (self, make, model, year): 
"" "初始 化 父 类 的 属性 。""" 
@ super(). init (make, model, year) 


©@ my tesla = ElectricCar('tesla', 'model s', 2019) 
print(my_ tesla.get descriptive name()) 


首先 是 Car 类 的 代码 ( 见 @ )。 创建 子 类 时 ， 父 类 必须 包含 在 当前 文件 中 ， 且 位 于 子 类 前 面 。 
在 @ 处 ,定义 了 子 类 ElectricCar。 定 义 子 类 时 ,必须 在 圆 括号 内 指定 父 类 的 名 称 ,方法 _init_() 
接受 创建 Car 实例 所 需 的 信息 ( 见 @ )。 


@ 处 的 super() 是 一 个 特殊 函数 ， 让 你 能 够 调用 父 类 的 方法 。 这 行 代码 让 Python 调用 Car 类 
的 方法 _init ()， 让 ElectricCar 实例 包含 这 个 方法 中 定义 的 所 有 属性 。 父 类 也 称 为 超 类 
( superclass )， 名 称 super 由 此 而 来 。 


为 测试 继承 能 够 正确 地 发 挥 作用 , 我 们 尝试 创建 一 辆 电动 汽车 , 但 提供 的 信息 与 创建 普通 汽 
车 时 相同 。 在 @ 人 处， 创建 ElectricCar 类 的 一 个 实例 ， 并 将 其 赋 给 变量 my_tesla。 这 行 代码 调用 
ElectricCar 类 中 定义 的 方法 _init (),， 后 者 让 Python 调用 父 类 car 中 定义 的 方法 _init ()。 
我 们 提供 了 实 参 'tesla' 、'model s' 和 2019。 


本 
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除 方法 _init _() 外 ,电动 汽 车 没有 其 他 特有 的 属性 和 方法 。 当 前 ,我 们 只 想 确认 电动 汽车 
具备 普通 汽车 的 行为 : 


2019 Tesla Model S$ 


ElectricCar 实例 的 行为 与 Car 实例 一 样 ， 现 在 可 以 开始 定义 电动 汽车 特有 的 属性 和 方法 了 。 


9.3.2 ”给 子 类 定义 属性 和 方法 
让 一 个 类 继承 另 一 个 类 后 ， 就 可 以 添加 区 分 子 类 和 父 类 所 需 的 新 属性 和 新 方法 了 。 


下 面 来 添加 一 个 电动 汽车 特有 的 属性 ( 电瓶 )， 以 及 一 个 描述 该 属性 的 方法 。 我 们 将 存储 电 
瓶 容 量 ， 并 编写 一 个 打印 电瓶 描述 的 方法 : 


class Car: 
-- Snip-- 


class ElectricCar(Car): 
"" "电动 汽 车 的 独特 之 处 。""" 


def init (self, make, model, year): 


初始 化 父 类 的 属性 。 
再 初始 化 电动 汽车 特有 的 属性 。 


super(). init (make, model, year) 
© self.battery size = 75 


© def describe battery(self) 
"0" 打 印 二 条 描述 电 旅 容量 的 消息 "om" 
print(f"This car has a {self.battery size}-kWh battery.") 


my_tesla = ElectricCar('tesla', 'model s', 2019) 
print(my tesla.get descriptive name()) 
my_tesla.describe battery() 


在 @ 处 ， 添 加 了 新 属性 self.battery size， 并 设置 其 初始 值 (75 )。 根 据 ElectricCar 类 创 
建 的 所 有 实例 都 将 包含 该 属性 ， 但 所 有 Car 实例 都 不 包含 它 。 在 @ 处 ， 还 添加 了 一 个 名 为 
describe_battery() 的 方法 ， 打 印 有 关 电 瓶 的 信息 。 调 用 这 个 方法 时 ， 将 看 到 一 条 电动 汽车 特有 
的 描述 : 


2019 Tesla Model S 
This car has a 75-kWh battery. 


对 于 ElectricCar 类 的 特殊 程度 没有 任何 限制 。 模 拟 电动 汽车 时 ， 可 根据 所 需 的 准确 程度 添 
加 任意 数量 的 属性 和 方法 。 如 果 一 个 属性 或 方法 是 任何 汽车 都 有 的 ,而 不 是 电动 汽车 特有 的 ,就 
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应 将 其 加 入 到 Car 类 而 非 ElectricCar 类 中 。 这 样 ， 使 用 car 类 的 人 将 获得 相应 的 功能 ， 而 
ElectricCar 类 只 包含 处 理 电动 汽车 特有 属性 和 行为 的 代码 。 


9.3.3” 重 写 父 类 的 方法 

对 于 父 类 的 方法 ， 只 要 它 不 符合 子 类 模拟 的 实物 的 行为 ,都 可 以 进行 重 写 。 为 此 ,可 在 子 类 
中 定义 一 个 与 要 重 写 的 父 类 方法 同名 的 方法 。 这 样 ，Python 将 不 会 考虑 这 个 父 类 方法 ,而 只 关注 
你 在 子 类 中 定义 的 相应 方法 。 

假设 Car 类 有 一 个 名 为 fill gas tank() 的 方法 ， 它 对 全 电动 汽车 来 说 毫 无 意义 ， 因 此 你 可 
能 想 重 写 它 。 下 面 演示 了 一 种 重 写 方式 : 


class ElectricCar(Car): 
-- Snip-- 


def fill gas tank(self): 


"电动 汽车 没有 油箱 。""" 
print("This car doesn't need a gas tank!") 


现在 ， 如 果 有 人 对 电动 汽车 调用 方法 fill gas_tank()，Python 将 忽略 Car 类 中 的 方法 
fi]] gas_tank()， 转 而 运行 上 述 代 码 。 使 用 继承 时 ， 可 让 子 类 保留 从 父 类 那里 继承 而 来 的 精华 ， 
并 剔除 不 需要 的 糟粕 。 


9.3.4 ”将 实例 用 作 属性 


使 用 代码 模拟 实物 时 , 你 可 能 会 发 现 自己 给 类 添加 的 细节 越 来 越 多 : 属性 和 方法 清单 以 及 文 
件 都 越 来 越 长 。 在 这 种 情况 下 ， 可 能 需要 将 类 的 一 部 分 提取 出 来 ， 作 为 一 个 独立 的 类 。 可 以 将 大 
型 类 拆 分 成 多 个 协同 工作 的 小 类 。 

例如 ， 不断 给 ElectricCar 类 添加 细节 时 ， 我 们 可 能 发 现 其 中 包含 很 多 专门 针对 汽车 电瓶 的 
属性 和 方法 。 在 这 种 情况 下 ， 可 将 这 些 属性 和 方法 提取 出 来 ， 放 到 一 个 名 为 Battery 的 类 中 ,并 
将 一 个 Battery 实例 作为 ElectricCar 类 的 属性 : 


class Car: 
-- Snip-- 


@ class Battery: 
"一 次 模拟 电动 汽车 电 族 的 简单 尝试 。""" 


@ def init (self, battery size=75) 
mu 初始 化 电文 的 属性 。""" 
self.battery size = battery size 


(3 def describe battery(self) 
""" 打 印 一 条 描述 电 竹 容量 的 消息 。"" 
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print(f"This car has a {self.battery size}-kWh battery.") 


class ElectricCar(Car): 
"" "电动 汽 车 的 独特 之 处 。"" 


def init (self, make, model, year): 


初始 化 父 类 的 属性 。 
再 初始 化 电动 汽车 特有 的 属性 


super(). init (make, model, year) 
9 self.battery = Battery() 
my_tesla = ElectricCar('tesla', 'model s', 2019) 


print(my tesla.get descriptive name()) 
my_tesla.battery.describe battery() 


@ 处 定义 一 个 名 为 Battery 的 新 类 ， 它 没有 继承 任何 类 。@ 处 的 方法 _init _() 除 self 外 ， 


还 有 男 一 个 形 参 battery size。 这 个 形 参 是 可 选 的 : 


如 果 没 有 给 它 提供 值 ， 电瓶 容量 将 被 设置 为 


75。 方法 describe battery() 也 移 到 了 这 个 类 中 ( 见 @ )。 
在 ElectricCar 类 中 ,添加 了 一 个 名 为 self.battery 的 属性 ( 见 @ )。 这 行 代 码 让 Python 创 


建 一 个 新 的 Battery 实例 ( 因为 没有 指定 容量 ， 


self.battery。 每 当 方 法 _init _() 被 调用 时 , 都 将 执行 该 操作 , 因此 现在 每 个 ElectricCar 实例 


都 包含 一 个 自动 创建 的 Battery 实例 。 


所 以 为 默认 值 75 )， 并 将 该 实例 赋 给 属性 


我 们 创建 一 辆 电动 汽车 , 并 将 其 赋 给 变量 my_tes1la。 描述 电瓶 时 , 需要 使 用 电动 汽车 的 属性 


battery: 


my_tesla.battery.describe battery() 


这 行 代码 让 Python 在 实例 my_tesla 中 查找 属 诉 
例 调用 方法 describe battery()。 


输出 与 你 在 前 面 看 到 的 相同 : 


E battery, 并 对 存储 在 该 属性 中 的 Battery 实 


2019 Tesla Model S 
This car has a 75-kWh battery. 


这 看 似 做 了 很 多 额外 的 工作 ， 但 是 现在 想 多 详细 地 描述 电瓶 都 可 以 ， 且 不 会 导致 Electric- 
Car 类 混乱 不 堪 。 下 面 再 给 Battery 类 添加 一 个 方法 ， 它 根据 电瓶 容量 报告 汽车 的 续航 里 程 : 


class Car: 
-- SNip-- 
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class Battery: 
-- SNip-- 


© def get range(self): 
""" 打 印 一 条 消息 ， 指 出 电 痊 的 续航 里 程 。""" 
if self.battery size == 75: 


range = 260 
elif self.battery size == 100: 
range = 315 


print(f"This car can go about {range} miles on a full charge.") 


class ElectricCar(Car): 
-- Ship-- 


my_ tesla = ElectricCar('tesla', "model s', 2019) 
print(my tesla.get descriptive name()) 
my_tesla.battery.describe battery() 

@ my tesla.battery.get range() 


@ 处 新 增 的 方法 get_range() 做 了 一 些 简单 的 分 析 : 如 果 电 瓶 的 容量 为 73 kW . h， 就 将 续航 
里 程 设置 为 260 英里 ; 如 果 容 量 为 100 kW :h, 就 将 续航 里 程 设置 为 315 英里 , 然后 报告 这 个 值 。 
为 使 用 这 个 方法 ， 也 需要 通过 汽车 的 属性 battery 来 调用 ( 见 @ )。 


输出 指出 了 汽车 的 续航 里 程 (这 取决 于 电瓶 的 容量 ): 


2019 Tesla Model S 
This car has a 75-kWh battery. 
This car can go about 260 miles on a full charge. 


9.3.5 ”模拟 实物 


模拟 较 复杂 的 物件 ( 如 电动 汽车 ) 时 ， 需 要 解决 一 些 有 趣 的 问题 。 续 航 里 程 是 电瓶 的 属性 还 
是 汽车 的 属性 呢 ? 如 果 只 描述 一 辆 汽车 ， 将 方法 get range() 放 在 Battery 类 中 也 许 是 合适 的 ， 
但 如 果 要 描述 一 家 汽车 制造 商 的 整个 产品 线 ， 也 许 应 该 将 方法 get_range() 移 到 ElectricCar 类 
中 。 在 这 种 情况 下 ，get_range() 依 然 根 据 电瓶 容量 来 确定 续航 里 程 ， 但 报告 的 是 一 款 汽车 的 续 
航 里 程 。 也 可 以 这 样 做 : 仍 将 方法 get range() 留 在 Battery 类 中 ， 但 向 它 传递 一 个 参数 ， 如 
car_model。 在 这 种 情况 下 ， 方 法 get_range() 将 根据 电瓶 容量 和 汽车 型 号 报告 续航 里 程 。 


这 让 你 进入 了 程序 员 的 另 一 个 境界 : 解决 上 述 问 题 时 ， 从 较 高 的 逻辑 层面 ( 而 不 是 语法 层面 ) 
考虑 ; 考虑 的 不 是 Python， 而 是 如 何 使 用 代码 来 表示 实物 。 达 到 这 种 境界 后 ， 你 会 经 常 发 现 ,对 
现实 世界 的 建 模 方法 没有 对 错 之 分 。 有 些 方法 的 效率 更 高 , 但 要 找 出 效率 最 高 的 表示 法 , 需要 经 
过 一 定 的 实践 。 只 要 代码 像 你 希望 的 那样 运行 ， 就 说 明 你 做 得 很 好 ! 即便 发 现 自己 不 得 不 多 次 尝 
试 使 用 不 同 的 方法 来 重 写 类 ， 也 不 必 气 蚀 。 要 编写 出 高 效 、 准 确 的 代码 ， 都 得 经 过 这 样 的 过 程 。 
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动手 试 一 斌 

练习 9-6: 冰激凌 小 店 冰激凌 小 店 是 一 种 特殊 的 餐馆 。 编 写 一 个 名 为 IceCreamStand 
的 类 ， 让 它 继承 为 完成 练习 9-1 或 练习 9-4 而 编写 的 Restaurant 类 。 这 两 个 版 本 的 
Restaurant 类 都 可 以 ， 挑 选 你 更 喜欢 的 那个 即 可 。 添加 一 个 名 为 人 avors 的 属性 ， 用 于 
存储 一 个 由 各 种 口味 的 冰激凌 组 成 的 列表 。 编写 一 个 显示 这 些 冰激凌 的 方法 。 创建 一 个 
IceCreamStand 实例 ， 并 调用 这 个 方法 。 

练习 9-7: 管理 员 管理 员 是 一 种 特殊 的 用 户 。 编 写 一 个 名 为 Admin 的 类 ， 让 它 继 
承 为 完成 练习 9-3 或 练习 9-5 而 编写 的 User 类 。 添 加 一 个 名 为 privileges 的 属性 ， 用 
于 存储 一 个 由 字符 串 (如 "can add post"、"can delete post"、"can ban user" 等 ) 组 


成 的 列表 。 编 写 一 个 名 为 show privileges() 的 方法 ,显示 管理 员 的 权限 ,创建 一 个 Admin 
实例 ， 并 调用 这 个 方法 。 


练习 9-8: 权限 编写 一 个 名 为 Privileges 的 类 ， 它 只 有 一 个 属性 privileges, 其 
中 存储 了 练习 9-7 所 述 的 字符 串 列表 。 将 方法 show privileges() 移 到 这 个 类 中 ,在 Admin 
类 中 ， 将 一 个 Privileges 实例 用 作 其 属性 。 创建 一 个 Admin 实例 ， 并 使 用 方法 
show privileges() 来 显示 其 权限 。 

练习 9-9: 电 浇 升级 在 本 节 最 后 一 个 electric car.py 版 本 中 ,给 Battery 类 添加 一 
个 名 为 upgrade_battery() 的 方法 。 该 方法 检查 电瓶 容量 ， 如 果 不 是 100， 就 将 其 设置 为 
100。 创 建 一 辆 电瓶 容量 为 默认 值 的 电动 汽车 ， 调 用 方法 get_ range() ， 然 后 对 电瓶 进行 
升级 ， 并 再 次 调用 get range()。 你 将 看 到 这 辆 汽车 的 续航 里 程 增 加 了 。 
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随 着 不 断 给 类 添加 功能 , 文件 可 能 变 得 很 长 ,即便 妥 善 地 使 用 了 继承 亦 如 此 。 为 遵循 Python 
的 总 体 理念 ， 应 让 文件 尽 可 能 整洁 。Python 在 这 方面 提供 了 帮助 ， 允 许 将 类 存储 在 模块 中 ,然后 
在 主 程序 中 导入 所 需 的 模块 。 


9.4.1 导入 单个 类 


下 面 来 创建 一 个 只 包含 Car 类 的 模块 。 这 让 我 们 面临 一 个 微妙 的 命名 问题 : 在 本 章 中 已 经 有 
一 个 名 为 car.py 的 文件 ， 但 这 个 模块 也 应 命名 为 car.py， 因 为 它 包含 表示 汽车 的 代码 。 我 们 将 这 
样 解决 这 个 命名 问题 : 将 Car 类 存储 在 一 个 名 为 car.py 的 模块 中 ,该 模块 将 覆盖 前 面 使 用 的 文件 
car.py。 从 现在 开始 ,使 用 该 模块 的 程序 都 必须 使 用 更 具体 的 文件 名 ， 如 my_car.py。 下 面 是 模块 
carpy， 其 中 只 包含 Car 类 的 代码 : 
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carpy 加 “一 个 可 用 于 表示 汽车 的 类 。 


class Car: 
mn 一 次 模拟 汽车 的 简单 尝试 。""" 


def init (self, make, model, year): 
"" "初始化 描述 汽车 的 属性 
self.make = make 
self.model = model 
self.year = year 
self.odometer reading = 0 


def get descriptive name(self): 
""" 返 回 整 洁 的 描述 性 名 称 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 


def read odometer(self): 
""" 打 印 一 条 消息 ， 指 出 汽车 的 里 程 。""" 
print(f"This car has {self.odometer reading} miles on it.") 


def update odometer(self, mileage): 


将 里 程 表 读数 设置 为 指定 的 值 
拒绝 将 里 程 表 往 回调 。 


if mileage >= self.odometer Teading: 
self.odometer reading = mileage 
else: 
print("You can't roll back an odometer!") 


def increment odometer(self, miles): 
""" 将 里 程 表 读数 增加 指定 的 量 。"" 
self.odometer reading += miles 


@ 处 包含 一 个 模块 级 文档 字符 串 ， 对 该 模块 的 内 容 做 了 简要 的 描述 。 你 应 为 自己 创建 的 每 个 
模块 编写 文档 字符 串 。 


下 面 来 创建 另 一 个 文件 my_carpy， 在 其 中 导入 Car 类 并 创建 其 实例 : 


my _ carpy 四 from car import Car 


my_new car = Car('audi', 'a4', 2019) 
print(my new car.get descriptive name()) 


my_new car.odometer reading = 23 
my_new_car.read odometer() 


@ 处 的 import 语句 让 Python 打开 模块 car 并 导入 其 中 的 Car 类 。 这 样 , 我们 就 可 以 使 用 Car 
类 ， 就 像 它 是 在 这 个 文件 中 定义 的 一 样 。 输 出 与 我 们 在 前 面 看 到 的 一 样 : 
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2019 Audi A4 
This car has 23 miles on it. 


导入 类 是 一 种 有 效 的 编程 方式 。 如 果 这 个 程序 包含 整个 Class 类 ， 它 该 有 多 长 啊 ! 通过 将 这 
个 类 移 到 一 个 模块 中 并 导入 该 模块 , 依然 可 以 使 用 其 所 有 功能 , 但 主 程序 文件 变 得 整洁 而 易于 阅 
读 了 。 这 还 让 你 能 够 将 大 部 分 逻辑 存储 在 独立 的 文件 中 。 确定 类 像 你 希望 的 那样 工作 后 ,就 可 以 
不 管 这 些 文件 ， 而 专注 于 主 程序 的 高 级 逻辑 了 。 


9.4.2 在 一 个 模块 中 存储 多 个 类 


虽然 同一 个 模块 中 的 类 之 间 应 存在 某 种 相关 性 , 但 可 根据 需要 在 一 个 模块 中 存储 任意 数量 的 
类 。Battery 类 和 ElectricCar 类 都 可 帮助 模拟 汽车 ， 下 面 将 它们 都 加 入 模块 carpy 中 : 


入 


car.py """ 一 组 用 于 表示 燃油 汽车 和 电动 汽车 的 类 。""" 


class Car: 
-- Snip-- 


class Battery: 
"一 次 模拟 电动 汽车 电 疙 的 简单 尝试 。""" 


def init (self, battery size=75): 
"" "初始 化 电 痊 的 属性 。""" 
self.battery size = battery size 


def describe battery(self): 
""" 打 印 一 条 描述 电 汶 容量 的 消息 。""" 
print(f"This car has a {self.battery size}-kWh battery.") 


def get Tange(self) : 
""" 打 印 一 条 描述 电 诈 续 航 里 程 的 消息 
if self.battery size == 75: 


range = 260 
elif self.battery size == 100: 
range = 315 


print(f"This car can go about {range} miles on a full charge.") 


class ElectricCar(Car): 
""" 模 拟 电动 汽车 的 独特 之 处 


def init (self, make, model, year): 


初始 化 父 类 的 属性 。 
再 初始 化 电动 汽车 特有 的 属性 。 


super(). init (make, model, year) 
self.battery = Battery() 
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现在 ， 可 以 新 建 一 个 名 为 my_electric_car.py 的 文件 ， 导 入 ElectricCar 类 ， 并 创建 一 辆 电动 
汽车 三 3 


my_eleciric from car import ElectricCar 


car.py 
my_ tesla = ElectricCar('tesla', 'model s', 2019) 


print(my tesla.get descriptive name()) 
my_tesla.battery.describe battery() 
my_tesla.battery.get range() 


输出 与 我 们 在 前 面 看 到 的 相同 ， 但 大 部 分 逻辑 隐藏 在 一 个 模块 中 : 


2019 Tesla Model S 
This car has a 75-kWh battery. 
This car can go about 260 miles on a full charge. 


9.4.3 ”从 一 个 模块 中 导入 多 个 类 


可 根据 需要 在 程序 文件 中 导入 任意 数量 的 类 。 如 果 要 在 同一 个 程序 中 创建 
车 ， 就 需要 将 Car 类 和 ElectricCar 类 都 导入: 


tt 
了 i 


通 汽 车 和 电动 汽 


mycarspy ©@ from car import Car, ElectricCar 


@ my beetle = Car('volkswagen', 'beetle', 2019) 
print(my_beetle.get descriptive name()) 


@ my tesla = ElectricCar('tesla', 'roadster', 2019) 
print(my tesla.get descriptive name()) 


在 @ 处 从 一 个 模块 中 导入 多 个 类 时 ， 用 去 号 分 隔 了 各 个 类 。 导 入 必要 的 类 后 ,就 可 根据 需要 
创建 每 个 类 的 任意 数量 实例 。 

在 本 例 中 ,在 @ 处 创建 了 一 辆 大 众 甲 过 虫 普通 汽车 ， 并 在 @ 处 创建 了 一 辆 特 斯 拉 Roadster 电 
动 汽车 : 


2019 Volkswagen Beetle 
2019 Tesla Roadster 


9.4.4 ”导入 整个 模块 


还 可 以 导入 整个 模块 , 再 使 用 句点 表示 法 访问 需要 的 类 。 这 种 导入 方式 很 简单 ,代码 也 易于 
阅读 。 因 为 创建 类 实例 的 代码 都 包含 模块 名 ， 所 以 不 会 与 当前 文件 使 用 的 任何 名 称 发 生 冲 突 。 


下 面 的 代码 导入 整个 car 模块 ， 并 创建 一 辆 普通 汽车 和 一 辆 电动 汽车 : 
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my_cars.py @ import car 


@ my beetle = car.Car('volkswagen', 'beetle', 2019) 
print(my beetle.get descriptive name()) 


©@ my tesla = car.ElectricCar('tesla', 'roadster', 2019) 
print(my tesla.get descriptive name()) 


在 @ 处 ， 导 入 了 整个 car 模块 。 接 下 来 ,使 用 语法 woduwle_name. ClassName 访问 需要 的 类 。 
像 前 面 一 样 ， 在 @ 处 创建 一 辆 大 众 甲 沉 忠 汽车， 并 在 @ 处 创建 一 辆 特 斯 拉 Roadster 汽车 。 


9.4.5 导入 模块 中 的 所 有 类 
要 导入 模块 中 的 每 个 类 ， 可 使 用 下 面 的 语法 : 


from module name import * 


不 推荐 使 用 这 种 导入 方式 ， 原 因 有 二 。 第 一 ， 如 果 只 看 文件 开头 的 import 语句 ， 就 能 清楚 
地 知道 程序 使 用 了 哪些 类 , 将 大 有 神 益 。 然 而 这 种 导 人 方式 没有 明确 地 指出 使 用 了 模块 中 的 哪些 
类 。 第 二 , 这 种 方式 还 可 能 引发 名 称 方面 的 迷惑 。 如 果 不 小 心 导 入 了 一 个 与 程序 文件 中 其 他 东西 
同名 的 类 , 将 引发 难以 诊断 的 错误 。 这 里 之 所 以 介绍 这 种 导入 方式 ,是 因为 虽然 不 推荐 使 用 , 但 
你 可 能 在 别人 编写 的 代码 中 见 到 它 。 

需要 从 一 个 模块 中 导入 很 多 类 时 ， 最 好 导入 整个 模块 ， 并 使 用 wodw7e_name. ClassNWame 语法 
来 访问 类 。 这 样 做 时 ， 虽 然 文件 开头 并 没有 列 出 用 到 的 所 有 类 , 但 你 清楚 地 知道 在 程序 的 哪些 地 
方 使 用 了 导入 的 模块 。 这 也 避免 了 导 和 人 模块 中 的 每 个 类 可 能 引发 的 名 称 冲突 。 


9.4.6 在 一 个 模块 中 导入 另 一 个 模块 


有 时候, 需要 将 类 分 散 到 多 个 模块 中 ,以 免 模 块 太 大 或 在 同一 个 模块 中 存储 不 相关 的 类 。 将 
类 存储 在 多 个 模块 中 时 ,你 可 能 会 发 现 一 个 模块 中 的 类 依赖 于 男 一 个 模块 中 的 类 ,在 这 种 情况 下 ， 
可 在 前 一 个 模块 中 导入 必要 的 类 。 

下 面 将 Car 类 存储 在 一 个 模块 中 ， 并 将 ElectricCar 类 和 Battery 类 存储 在 另 一 个 模块 中 。 
将 第 二 个 模块 命名 为 electric_carpy ( 这 将 覆盖 前 面 创建 的 文件 electric_carpy )， 并 将 Battery 类 
和 ElectricCar 类 复制 到 这 个 模块 中 : 


eleciric_carpy “"，"" 一 组 可 用 于 表示 电 动 汽 车 的 类 。""" 
@ from car import Car 


class Battery: 
-- Snip-- 
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class ElectricCar(Car): 
-- SNip-- 


ElectricCar 类 需要 访问 其 父 类 Car， 因 此 在 @ 处 直接 将 Car 类 导入 该 模块 中 。 如 果 忘 记 了 这 
行 代码 ，Python 将 在 我 们 试图 创建 ElectricCar 实例 时 引发 错误 。 还 需要 更 新 模块 car， 使 其 只 


包含 Car 类 : 


corpy """ 一 个 可 用 于 表示 汽车 的 类 。""" 


class Car: 
-- SNip-- 


现在 可 以 分 别 从 每 个 模块 中 导入 类 ， 以 根据 需要 创建 任何 类 型 的 汽车 了 : 


mycarspy ©@ from Car import Car 
from electric car import ElectricCar 


my_beetle = Car('volkswagen', 'beetle', 2019) 
print(my_beetle.get descriptive name()) 


my_tesla = ElectricCar('tesla', 'roadster', 2019) 
print(my tesla.get descriptive name()) 


在 @ 处 ， 从 模块 car 中 导入 了 Car 类 ， 并 从 模块 electric car 中 导入 ElectricCar 类 。 接 下 
来 ,创建 了 一 辆 普通 汽车 和 一 辆 电动 汽车 。 这 两 种 汽车 都 被 正确 地 创建 出 来 了 : 


2019 Volkswagen Beetle 
2019 Tesla Roadster 


9.4.7 ”使 用 别名 
第 8 章 说 过 ， 使 用 模块 来 组 织 项 目 代码 时 ， 别 名 大 有 神 益 。 导 入 类 时 ， 也 可 为 其 指定 别名 。 


例如 ， 要 在 程序 中 创建 大 量 电动 汽车 实例 ， 需 要 反复 输入 ElectricCar， 非 常 烦琐 。 为 避免 
这 种 烦恼 ， 可 在 import 语句 中 给 ElectricCar 指定 一 个 别名 : 


from electric car import ElectricCar as EC 


现在 每 当 需 要 创建 电动 汽车 实例 时 ， 都 可 使 用 这 个 别名 : 


my_ tesla = EC('tesla', 'roadster', 2019) 


9.4.8 自 定义 工作 流程 
如 你 所 见 , 在 组 织 大 型 项 目的 代码 方面 , Python 提供 了 很 多 选项 。 熟 悉 所 有 这 些 选 项 很 重要 ， 
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这 样 你 才能 确定 哪 种 项 目 组 织 方式 是 最 佳 的 ， 并 能 理解 别人 开发 的 项 目 。 

一 开始 应 让 代码 结构 尽 可 能 简单 。 先 尽 可 能 在 一 个 文件 中 完成 所 有 的 工作 , 确定 一 切 都 能 正 
确 运 行 后 ,再 将 类 移 到 独立 的 模块 中 。 如 果 你 喜欢 模块 和 文件 的 交互 方式 ,可 在 项 目 开始 时 就 举 
试 将 类 存储 到 模块 中 。 先 找 出 让 你 能 够 编写 出 可 行 代码 的 方式 ， 再 尝试 改进 代码 。 


动手 试 一 斌 
练习 9-10: 导入 Restaurant 类 将 最 新 的 Restaurant 类 存储 在 一 个 模块 中 。 在 另 
一 个 文件 中 ， 导 入 Restaurant 类 ， 创 建 一 个 Restaurant 实例 并 调用 Restaurant 的 一 个 
方法 ， 以 确认 import 语句 正确 无 误 。 
练习 9-11: 导入 Admin 类 以 为 完成 练习 9-8 而 做 的 工作 为 基础 。 将 User 类 、 


Privileges 类 和 Admin 类 存储 在 一 个 模块 中 ， 再 创建 一 个 文件 ， 在 其 中 创建 一 个 Admin 
实例 并 对 其 调用 方法 show privileges()， 以 确认 一 切 都 能 正确 运行 。 

练习 9-12: 多 个 模块 ”将 User 类 存储 在 一 个 模块 中 ， 并 将 Privileges 类 和 Admin 
类 存储 在 另 一 个 模块 中 。 再 创建 一 个 文件 ， 在 其 中 创建 一 个 Admin 实例 并 对 其 调用 方法 
show privileges()， 以 确认 一 切 依然 能 够 正确 运行 。 


9.5 “Python 标准 库 


Python 标准 库 是 一 组 模块 ， 我 们 安装 的 Python 都 包含 它 。 你 现在 对 函数 和 类 的 工作 原理 已 
有 大 致 的 了 解 ， 可 以 开始 使 用 其 他 程序 员 编 写 好 的 模块 了 。 可 以 使 用 标准 库 中 的 任何 函数 和 类 ， 
只 需 在 程序 开头 包含 一 条 简单 的 import 语句 即 可 。 下 面 来 看 看 模块 random， 它 在 你 模拟 很 多 现 
实情 况 时 很 有 用 。 


在 这 个 模块 中 ， 一 个 有 趣 的 函数 是 randint()。 它 将 两 个 整数 作为 参数 ， 并 随机 返回 一 个 位 
于 这 两 个 整数 之 间 ( 含 ) 的 整数 。 下 面 演示 了 如 何 生 成 一 个 位 于 1 和 6 之 间 的 随机 整数 : 


>>> from random import randint 
>>> randint(1, 6) 
3 


在 模块 random 中 ， 男 一 个 有 用 的 函数 是 choice()。 它 将 一 个 列表 或 元 组 作为 参数 ， 并 随机 
返回 其 中 的 一 个 元 素 : 


>>> from random import choice 
>>> players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
>>> first up = choice(players) 
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>>> first_up 
‘florence’ 


创建 与 安全 相关 的 应 用 程序 时 , 请 不 要 使 用 模块 random, 但 该 模块 可 以 很 好 地 用 于 创建 众多 
有 趣 的 项 目 。 


注意 ”还 可 以 从 其 他 地 方 下 载 外 部 模块 。 第 二 部 分 的 每 个 项 目 都 需要 使 用 外 部 模块 ， 届 时 你 将 
看 到 很 多 此 类 示例 。 


动手 试 一 斌 


练习 9-13: 鹏 子 创建 一 个 Die 类 ， 它 包含 一 个 名 为 sides 的 属性 ， 该 属性 的 默认 
值 为 6。 编写 一 个 名 为 Tfoll die() 的 方法 ， 它 打印 位 于 1 般 子 面 数 之 间 的 随机 数 。 创 
建 一 个 6 面 的 角子 再 拨 10 次 。 

创建 一 个 10 面 的 奶子 和 一 个 20 面 的 鹏 子 ， 再 分 别 手 10 次 。 

练习 9-14: 彩票 ”创建 一 个 列表 或 元 组 ， 其 中 包含 10 个 数 和 5 个 字母 。 从 这 个 列 
表 或 元 组 中 随机 选择 4 个 数 或 字母 ， 并 打印 一 条 消息 ， 指 出 只 要 彩票 上 是 这 4 个 数 或 字 


于 类 村 < 

练习 9-15: 彩票 分 析 可 以 使 用 一 个 循环 来 明白 前 述 彩 票 大 奖 有 多 难 中 奖 。 为 此 ， 
创建 一 个 名 为 my_ticket 的 列表 或 元 组 ， 再 编写 一 个 循环 ， 不 断 地 随机 选择 数 或 字母 ， 
直到 中 大 奖 为 止 。 请 打印 一 条 消息 ， 报 告 执行 循环 多 少 次 才 中 了 大 奖 。 

练习 9-16: Python Module of the Week 要 了 解 Python 标准 库 ， 一 个 很 不 错 的 资 
源 是 网 站 Python Module ofthe Week。 请 访问 该 网 站 并 查看 其 中 的 目录 ， 找 一 个 你 感 兴 
趣 的 模块 进行 探索 。 从 模块 random 开始 可 能 是 个 不 错 的 选择 。 


9.6 ”类 编码 风格 


你 必须 熟悉 有 些 与 类 相关 的 编码 风格 问题 ， 在 编写 的 程序 较 复 杂 时 尤其 如 此 。 

类 名 应 采用 驼峰 命名 法 ， 即 将 类 名 中 的 每 个 单词 的 首 字 母 都 大 写 ， 而 不 使 用 下 划 线 。 实 例 名 
和 模块 名 都 采用 小 写 格式 ， 并 在 单词 之 间 加 上 下 划 线 。 

对 于 每 个 类 , 都 应 紧 跟 在 类 定义 后 面包 含 一 个 文档 字符 串 。 这 种 文档 字符 串 简要 地 描述 类 的 
功能 ， 并 遵循 编写 函数 的 文档 字符 串 时 采用 的 格式 约定 。 每 个 模块 也 都 应 包含 一 个 文档 字符 串 ， 
对 其 中 的 类 可 用 于 做 什么 进行 描述 。 


Ud 


9.7 小结 103 


可 使 用 空 行 来 组 织 代码 ， 但 不 要 滥用 。 在 类 中 ， 可 使 用 一 个 空 行 来 分 隔 方 法 ; 而 在 模块 中 ， 
可 使 用 两 个 空 行 来 分 隔 类 。 

需要 同时 导入 标准 库 中 的 模块 和 你 编写 的 模块 时 ， 先 编写 导入 标准 库 模 块 的 import 语句， 
再 添加 一 个 空 行 ， 然 后 编写 导入 你 自己 编写 的 模块 的 import 语句 。 在 包含 多 条 import 语句 的 程 
序 中 ， 这 种 做 法 让 人 更 容易 明白 程序 使 用 的 各 个 模块 都 来 自 何 处 。 


9.7 小 结 


在 本 章 中 ,你 学 习 了 : 如 何 编 写 类 ; 如 何 使 用 属性 在 类 中 存储 信息 ， 以 及 如 何 编 写 方法 ， 以 
让 类 具备 所 需 的 行为 ;， 如何 编写 方法 _init ()， 以 便 根据 类 创建 包含 所 需 属性 的 实例 。 你 见识 
了 如 何 修改 实例 的 属性 , 包括 直接 修改 以 及 通过 方法 进行 修改 。 你 还 了 解 了 使 用 继承 可 简化 相关 
类 的 创建 工作 ， 以 及 将 一 个 类 的 实例 用 作 男 一 个 类 的 属性 可 让 类 更 简洁 。 


你 了 解 到 , 通过 将 类 存储 在 模块 中 , 并 在 需要 使 用 这 些 类 的 文件 中 导入 它们 ,可 证 项 目 组 织 
有 序 。 你 学 习 了 Python 标准 库 ， 并 见识 了 一 个 使 用 模块 random 的 示例 。 最 后 ， 你 学 习 了 编写 类 
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在 第 10 章 中 ， 你 将 学 习 如 何 使 用 文件 ， 这 让 你 能 够 保存 你 在 程序 中 所 做 的 工作 ， 以 及 你 让 
用 户 做 的 工作 。 你 还 将 学 习 异 常 ， 这 是 一 种 特殊 的 Python 类 ， 用 于 帮助 你 在 发 生 错误 时 采取 相 
应 的 措施 。 


文件 和 异常 


至 此 ,你 掌握 了 编写 组 织 有 序 、 易 于 使 用 的 程序 所 需 的 基本 技能 ， 
该 考虑 让 程序 目标 更 明确 、 用 途 更 大 了 。 在 本 章 中 ,你 将 学 习 处 理 文 
件 ， 让 程序 能 够 快速 地 分 析 大 量 数据 ; 你 将 学 习 错 误 处 理 ， 避 免 程 序 
在 面 对 意 外 情形 时 前 溃 ; 你 将 学 习 异 常 ， 它 们 是 Python 创建 的 特殊 
对 象 , 用 于 管理 程序 运行 时 出 现 的 错误 ; 你 还 将 学 习 模块 json， 它 让 
你 能 够 保存 用 户 数据 ， 以 免 在 程序 停止 运行 后 丢失 。 

学 习 处 理 文件 和 保存 数据 可 让 你 的 程序 使 用 起 来 更 容易 :用 户 将 
能 够 选择 输入 什么 样 的 数据 , 以 及 在 什么 时 候 输 入 ; 用 户 使 用 你 的 程 
序 做 一 些 工作 后 ， 可 将 程序 关闭 ， 以 后 再 接着 往 下 做 。 学 习 处 理 异常 可 帮助 你 应 对 文件 不 存 
在 的 情形 ,以 及 处 理 其 他 可 能 导致 程序 崩 江 的 问题 。 这 让 你 的 程序 在 面 对 错 误 的 数据 时 更 健 
壮 ,不管 这 些 错误 数据 源 自 无 意 的 错误 ， 还 是 源 自 破坏 程序 的 恶意 企图 。 你 在 本 章 学 习 的 技 
能 可 提高 程序 的 适用 性 、 可 用 性 和 稳定 性 。 


10.1 从 文件 中 读 取 数据 


文本 文件 可 存储 的 数据 量 多 得 难以 置信 : 天 气 数据 、 交 通 数据 、 社 会 经 济 数据 、 文 学 作品 等 。 
每 当 需 要 分 析 或 修改 存储 在 文件 中 的 信息 时 , 读 取 文件 都 很 有 用 ,对 数据 分 析 应 用 程序 来 说 尤其 
如 此 。 例 如 ， 可 以 编写 一 个 这 样 的 程序 : 读 取 一 个 文本 文件 的 内 容 , 重新 设置 这 些 数据 的 格式 并 
将 其 写 和 文件， 让 浏览 器 能 够 显示 这 些 内 容 。 

要 使 用 文本 文件 中 的 信息 ,首先 需要 将 信息 读 取 到 内 存 中 。 为 此 , 你 可 以 一 次 性 读 取 文件 的 
全 部 内 容 ， 也 可 以 以 每 次 一 行 的 方式 逐步 读 取 。 


10.1.1 读 取 整个 文件 
要 读 取 文件 , 需要 一 个 包含 几 行文 本 的 文件 。 下 面 首先 创建 一 个 文件 ， 它 包 含 精 确 到 小 数 点 
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后 30 位 的 圆周 率 值 ， 且 在 小 数 点 后 每 10 位 处 换行 : 


pi_digits.txt 3.1415926535 
8979323846 
2643383279 


要 动手 尝试 后 续 示 例 , 可 在 编辑 器 中 输入 这 些 数据 行 , 再 将 文件 保存 为 pi_digits.txt， 也 可 从 
本 书 主页 (ituring.cn/book/2784 ) 下 载 该 文件 。 请 将 该 文件 保存 到 本 章程 序 所 在 的 目录 。 


下 面 的 程序 打开 并 读 取 这 个 文件 ， 再 将 其 内 容 显示 到 屏幕 上 : 


file readerpy with open('pi digits.txt') as file _ object: 
contents = file object.read() 
print(contents) 


在 这 个 程序 中 , 第 一 行 代码 做 了 大 量 的 工作 。 我 们 先 来 看 看 函数 open()。 要 以 任何 方式 使 用 
文件 ， 那 怕 仅 仅 是 打印 其 内 容 ， 都 得 先 打开 文件 ,才能 访问 它 。 也 数 open() 接 受 一 个 参数 : 要 打 
开 的 文件 的 名 称 。Python 在 当前 执行 的 文件 所 在 的 目录 中 查找 指定 的 文件 。 在 本 例 中 ， 当 前 运行 
的 是 file_reader.py， 因 此 Python 在 file_reader.py 所 在 的 目录 中 查找 pi_digits.txt。 函 数 open() 返 
回 一 个 表示 文件 的 对 象 。 在 这 里 ，open('pi digits.txt') 返 回 一 个 表示 文件 pi_digits.txt 的 对 象 ， 
Python 将 该 对 象 赋 给 file_ object 供 以 后 使 用 。 


关键 字 with 在 不 再 需要 访问 文件 后 将 其 关闭 。 在 这 个 程序 中 ， 注 意 到 我 们 调用 了 open()， 
但 没有 调用 close()。 也 可 以 调用 open() 和 close() 来 打开 和 关闭 文件 ， 但 这 样 做 时 ， 如 果 程 序 
存在 bug 导致 方法 close() 未 执行 ,文件 将 不 会 关闭 。 这 看 似 微不足道 ， 但 未 受 善 关闭 文件 可 能 
导致 数据 丢失 或 受 损 。 如 果 在 程序 中 过 早 调用 close() ， 你 会 发 现 需要 使 用 文件 时 它 已 关闭 (无 
法 访问 )， 这 会 导致 更 多 的 错误 。 并 非 在 任何 情况 下 都 能 轻松 确定 关闭 文件 的 恰当 时 机 ， 但 通过 
使 用 前 面 所 示 的 结构 ， 可 让 Python 去 确定 : 你 只 管 打开 文件 ， 并 在 需要 时 使 用 它 ，Python 自 会 
在 合适 的 时 候 自 动 将 其 关闭 。 

有 了 表示 pi_digits.txt 的 文件 对 象 后 ， 使 用 方法 read() ( 前 述 程序 的 第 二 行 ) 读 取 这 个 文件 
的 全 部 内 容 ， 并 将 其 作为 一 个 长 长 的 字符 串 赋 给 变量 contents。 这 样 ， 通 过 打印 contents 的 值 ， 
就 可 将 这 个 文本 文件 的 全 部 内 容 显 示 出 来 : 


3.1415926535 
8979323846 
2643383279 


相 比 于 原始 文件 , 该 输出 唯一 不 同 的 地 方 是 末尾 多 了 一 个 空 行 。 为 何 会 多 出 这 个 空 行 呢 ? 
为 read() 到 达 文 件 末 尾 时 返回 一 个 空 字符 串 , 而 将 这 个 空 字符 串 显 示 出 来 时 就 是 一 个 空 行 。 要 删 
除 多 出 来 的 空 行 ， 可 在 函数 调用 print() 中 使 用 rstrip(): 
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with open('pi digits.txt') as file object: 
contents = file object.read() 


print(contents.rstrip()) 


本 书 前 面 说 过 ,Python 方法 rstrip() 删 除 字 符 串 末尾 的 空白 。 现 在 , 输出 与 原始 文件 的 内 容 
完全 相同 : 


3.1415926535 
8979323846 
2643383279 


10.1.2 文件 路 径 


将 类 似 于 pi_digits.txt 的 简单 文件 名 传递 给 函数 open() 时 ,Python 将 在 当前 执行 的 文件 ( 即 .py 
程序 文件 ) 所 在 的 目录 中 查找 。 


根据 你 组 织 文件 的 方式 ， 有 时 可 能 要 打开 不 在 程序 文件 所 属 目 录 中 的 文件 。 例如 ,你 可 能 将 
旦 序 文件 存储 在 了 文件 夹 python_work 中 , 而 该 文件 夹 中 有 一 个 名 为 text_files 的 文件 夹 用 于 存储 
程序 文件 操作 的 文本 文件 。 虽然 文 件 夹 text_files 包含 在 文件 夹 python work 中 ， 但 仅 向 open() 
传递 位 于 前 者 中 的 文件 名 称 也 不 可 行 , 因为 Python 只 在 文件 夹 python work 中 查找 , 而 不 会 在 其 
子 文件 夹 text_files 中 查找 。 要 让 Python 打开 不 与 程序 文件 位 于 同一 个 目录 中 的 文件 ， 需 要 提供 
文件 路 径 ， 让 Python 到 系统 的 特定 位 置 去 查找 。 

由 于 文件 夹 text_files 位 于 文件 来 python work 中 ,可 以 使 用 相对 文件 路 径 来 打开 其 中 的 文件 。 
相对 文件 路 径 让 Python 到 指定 的 位 置 去 查找 ， 而 该 位 置 是 相对 于 当前 运行 的 程序 所 在 目录 的 。 
例如 ， 可 这 样 编写 代码 : 


a 


with open('text files/fi7ename.txt') as file object: 


这 行 代码 让 Python 到 文件 夹 python_work 下 的 文件 夹 text_files 中 去 查找 指定 的 .txt 文 件 。 


注意 显示 文件 路 径 时 ，Windows 系统 使 用 反 儿 本 (\ ) 而 不 是 斜 杠 (/ ), 但 在 代码 中 依然 可 以 
使 用 斜 杠 。 


还 可 以 将 文件 在 计算 机 中 的 准确 位 置 告诉 Python , 这 样 就 不 用 关心 当前 运行 的 程序 存储 在 什 
么 地 方 了 。 这 称 为 绝对 文件 路 径 。 在 相对 路 径 行 不 通 时 ， 可 使 用 绝对 路 径 。 例 如 ， 如 果 text_files 
并 不 在 文件 夹 python work 中 ， 而 在 文件 夹 other files 中 ， 则 向 open() 传 递 路 径 
'text files/ 廊 7ename.txt ' 行 不 通 ,因为 Python 只 在 文件 夹 python work 中 查找 该 位 置 。 为 明确 
指出 希望 Python 到 哪里 去 查找 ， 需 要 提供 完整 的 路 径 。 
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绝对 路 径 通 常 比 相对 路 径 长 ， 因 此 将 其 赋 给 一 个 变量 ， 青 将 该 变量 传递 给 open() 会 有 所 帮助 : 


file path = '/home/ehmatthes/other files/text files/fi7lename.txt' 
with open(file path) as file object: 


通过 使 用 绝对 路 径 ， 可 读 取 系统 中 任何 地 方 的 文件 。 就 目前 而 言 ， 最 简单 的 做 法 是 ， 要 人 么 
将 数据 文件 存储 在 程序 文件 所 在 的 目录 ， 要 么 将 其 存储 在 程序 文件 所 在 目录 下 的 一 个 文件 夹 
(如 text files ) 中 。 


注意 ”如果 在 文件 路 径 中 直接 使 用 反 斜 杜 ， 将 引发 错误 ， 因 为 反 斜 杠 用 于 对 字符 囊 中 的 字符 进 
行 转 义 。 例如， 对 于 路 径 "C:\path\to\file.txt"， 其 中 的 \t 将 被 解读 为 制 表 符 。 如 果 一 
定 要 使 用 反 斜 杠 ， 可 对 路 径 中 的 每 个 反 斜 杠 都 进行 转 义 ， 如 "C:\\path\\to\\file.txt"。 


10.1.3 ”了 逐 行 读 取 


读 取 文件 时 ,常常 需要 检查 其 中 的 每 一 行 : 可 能 要 在 文件 中 查找 特定 的 信息 , 或 者 要 以 某 种 
方式 修改 文件 中 的 文本 。 例如 ,你 可 能 要 遍历 一 个 包含 天 气 数据 的 文件 ,并 使 用 天 气 描述 中 包含 
sunny 字样 的 行 。 在 新 闻 报 道中 ,你 可 能 会 查找 包含 标签 cheadline> 的 行 ， 并 按 特 定 的 格式 设置 它 。 


要 以 每 次 一 行 的 方式 检查 文件 ， 可 对 文件 对 象 使 用 for 循环 : 


file readerpy 四 filename = 'pi digits.txt' 


@ with open(filename) as file object: 
(3 for line in file object: 
print(line) 


在 @ 处 ,将 要 读 取 的 文件 的 名 称 赋 给 变量 filename。 这 是 使 用 文件 时 的 一 种 常见 做 法 。 变 量 
filename 表示 的 并 非 实际 文件 它 只 是 一 个 让 Python 知道 到 哪里 去 查找 文件 的 字符 串 ， 因 此 
可 以 轻松 地 将 'pi_ digits.txt' 替 换 为 要 使 用 的 另 一 个 文件 的 名 称 。 调 用 open() 后 ， 将 一 个 表示 
文件 及 其 内 容 的 对 象 赋 给 了 变量 file object ( 见 @ )。 这 里 也 使 用 了 关键 字 with， 让 Python 负 
责 妥 善 地 打开 和 关闭 文件 。 为 查看 文件 的 内 容 , 通过 对 文件 对 象 执行 循环 来 遍历 文件 中 的 每 一 行 
( 见 @ )。 


打印 每 一 行 时 ， 发 现 空 白 行 更 多 了 : 


3.1415926535 


8979323846 


2643383279 
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为 何 会 出 现 这 些 空白 行 呢 ? 因为 在 这 个 文件 中 , 每 行 的 末尾 都 有 一 个 看 不 见 的 换行 符 , 而 函 
数 调 用 print() 也 会 加 上 一 个 换行 符 ， 因 此 每 行 末 尾 都 有 两 个 换行 符 : 一 个 来 自 文件 ， 另 一 个 来 
自 函 数 调 用 print()。 要 消除 这 些 多 余 的 空白 行 ， 可 在 函数 调用 print() 中 使 用 rstrip(): 


filename = 'pi digits.txt" 


with open(filename) as file object: 
for line in file object: 
print(line.rstrip()) 


现在 ,输出 又 与 文件 内 容 完全 相同 了 : 


3.1415926535 
8979323846 
2643383279 


10.1.4 创建 一 个 包含 文件 各 行内 容 的 列表 

使 用 关键 字 with 时 ，open() 返 回 的 文件 对 象 只 在 with 代码 块 内 可 用 。 如 果 要 在 with 代码 块 
外 访问 文件 的 内 容 ， 可 在 with 代码 块 内 将 文件 的 各 行 存储 在 一 个 列表 中 ， 并 在 with 代码 块 外 使 
用 该 列表 : 可 以 立即 处 理 文件 的 各 个 部 分 ， 也 可 以 推迟 到 程序 后 面 再 处 理 。 

下 面 的 示例 在 with 代码 块 中 将 文件 pi_digits.txt 的 各 行 存储 在 一 个 列表 中 , 再 在 with 代码 块 
外 打印 : 


filename = 'pi digits.txt" 


with open(filename) as file object: 
© lines = file object.readlines() 


@ for line in lines: 
print(line.rstrip()) 


@ 处 的 方法 readlines() 从 文件 中 读 取 每 一 行 ， 并 将 其 存储 在 一 个 列表 中 。 接 下 来 ， 该 列表 
被 赋 给 变量 lines。 在 with 代码 块 外 ,依然 可 使 用 这 个 变量 。 在 @ 处 ,使 用 一 个 简单 的 for 循环 
来 打印 lines 中 的 各 行 。 因 为 列表 lines 的 每 个 元 素 都 对 应 于 文件 中 的 一 行 ， 所 以 输出 与 文件 内 
容 完全 一 致 。 


10.1.5 ”使 用 文件 的 内 容 


将 文件 读 取 到 内 存 中 后 , 就 能 以 任何 方式 使 用 这 些 数据 了 。 下 面 以 简单 的 方式 使 用 圆周 率 的 
值 。 首 先 ， 创建 一 个 字符 串 ， 它 包含 文件 中 存储 的 所 有 数字 ， 且 没有 任何 空格 : 
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Pi_siring.py filename = "pi digits.txt' 


with open(filename) as file object: 
ines = file object.readlines() 


@ pi string = "" 
@ for line in lines: 
pi string += line.rstrip() 


@ print(pi string) 
print(len(pi string)) 


像 前 一 个 示例 一 样 ， 首 先 打 开 文件 ， 并 将 其 中 所 有 的 行 都 存储 在 一 个 列表 中 。 在 @ 处 ,创建 
了 一 个 变量 pi_string, 用 于 指向 圆周 率 的 值 。 接 下 来 , 使 用 一 个 循环 将 各 行 加 入 pi_string, 并 
删除 每 行 末尾 的 换行 符 ( 见 @ )。 在 @ 处 ， 打 印 这 个 字符 串 及 其 长 度 : 


3.1415926535 8979323846 2643383279 
36 


变量 pi string 指向 的 字符 串 包 含 原来 位 于 每 行 左 边 的 空格 ,为 删除 这 些 空格 ,可 使 用 strip() 
而 非 rstrip(): 


-- snip-- 10 


for line in lines: 
pi_string += line.strip() 


print(pi string) 
print(len(pi string)) 


这 样 就 获得 了 一 个 字符 串 ， 其 中 包含 准确 到 30 位 小 数 的 圆周 率 值 。 这 个 字符 串 长 32 字符 ， 
因为 它 还 包含 整数 部 分 的 3 和 小 数 点 : 


3.141592653589793238462643383279 
32 


注意 读 取 文本 文件 时 ，Python 将 其 中 的 所 有 文本 都 解读 为 字符 串 。 如 果 读 取 的 是 数 ， 并 要 将 
其 作为 数值 使 用 ， 就 必须 使 用 函数 int() 将 其 转换 为 整数 或 使 用 函数 float() 将 其 转换 为 
浮 点 数 。 


10.1.6 包含 一 百 万 位 的 大 型 文件 


前 面 分 析 的 都 是 一 个 只 有 三 行 的 文本 文件 , 但 这 些 代 码 示例 也 可 处 理 大 得 多 的 文件 。 如 果 我 
们 有 一 个 文本 文件 ， 其 中 包含 精确 到 小 数 点 后 1 000 000 位 而 不 是 30 位 的 圆周 率 值 ， 也 可 创建 一 
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个 包含 所 有 这 些 数字 的 字符 串 。 为 此 ,无 须 对 前 面 的 程序 做 任何 修改 ， 只 要 将 这 个 文件 传递 给 它 
即 可 。 在 这 里 ， 只 打印 到 小 数 点 后 50 位 ， 以 免 终 端 为 显示 全 部 1 000 000 位 而 不 断 滚动 : 


pistring.py filename = “pi million digits.txt 


with open(filename) as file object: 
lines = file object.readlines() 


pi string = "" 
for line in lines: 
i string += line.strip() 


print(f"{pi string[:52]}...") 
print(len(pi string)) 


输出 表明 ， 创 建 的 字符 串 确实 包含 精确 到 小 数 点 后 1 000 000 位 的 圆周 率 值 : 


3.14159265358979323846264338327950288419716939937510... 
1000002 


对 于 可 处 理 的 数据 量 , Python 没有 任何 限制 。 只 要 系统 的 内 存 足 够 多 ,你 想 处 理 多 少数 据 都 
可 以 o 


注意 ”要 运行 这 个 程序 ( 以 及 后 面 的 众多 示例 ), 需要 从 http://ituring.cn/book/2784 下 载 相关 的 资源 。 


10.1.7 圆周率 值 中 包含 你 的 生日 吗 


我 一 直 想 知道 自己 的 生日 是 否 包含 在 圆周 率 值 中 。 下 面 来 扩展 刚才 编写 的 程序 以 确定 某 个 
人 的 生日 是 否 包 含 在 圆周 率 值 的 前 1 000 000 位 中 。 为 此 ， 可 将 生日 表示 为 一 个 由 数字 组 成 的 字 
符 串 ， 再 检查 这 个 字符 串 是 否 包 含 在 pi_string 中 : 


-- Snip-- 
for line in lines: 
pi string += line.strip() 


@ birthday = input("Enter your birthday, in the form mmddyy: ") 
@ if birthday in pi string: 
print("Your birthday appears in the first million digits of pi!") 
else: 
print("Your birthday does not appear in the first million digits of pi.") 


在 @ 人 处， 提示 用 户 输入 生日 。 在 @ 处 ,检查 这 个 字符 串 是 否 包含 在 pi_string 中 。 下 面 来 运 
行 一 下 这 个 程序 : 


Enter your birthdate, in the form mmddyy: 120372 
Your birthday appears jin the first million digits of pil 
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我 的 生日 确实 出 现在 了 圆周 率 值 中 ! 读 取 文件 的 内 容 后 , 能 以 你 能 想到 的 任何 方式 对 其 进行 
分 析 [el 


动手 试 一 试 

练习 10-1: Python 学 习 笔记 在 文本 编辑 器 中 新 建 一 个 文件 ， 写 几 身 话 来 总 结 一 
下 你 至 此 学 到 的 Python 知识 ， 其 中 每 一 行 都 以 “In Python you can” 打 头 。 将 这 个 文件 
命名 为 learning_python.txt, 并 存储 到 为 完成 本 章 练 习 而 编写 的 程序 所 在 的 目录 中 。 编写 
一 个 程序 , 它 读 取 这 个 文件 , 并 将 你 所 写 的 内 容 打 印 三 次 : 第 一 次 打印 时 读 取 整 个 文件 ; 
第 三 次 打印 时 遍历 文件 对 象 ; 第 三 次 打印 时 将 各 行 存储 在 一 个 列表 中 ， 再 在 With 代码 
块 外 打印 它们 。 

练习 10-2: C 语言 学 习 笔 记 可 使 用 方法 Teplace() 将 字符 串 中 的 特定 单词 都 替换 
为 另 一 个 单词 。 下 面 是 一 个 简单 的 示例 ， 演 示 了 如 何 将 句子 中 的 'dog ' 替 换 为 "cat ' : 


>>> message = "I really like dogs." 
>>> message.replace('dog', 'cat') 
'I really like cats.’ 


读 取 你 刚 创建 的 文件 learning python.txt 中 的 每 一 行 ， 将 其 中 的 Python 都 替换 为 另 
一 门 语言 的 名 称 ， 比 如 C。 将 修改 后 的 各 行 都 打印 到 屏幕 上 。 


10.2” 写 入 文件 


保存 数据 的 最 简单 的 方式 之 一 是 将 其 写 入 文件 中 。 通过 将 输出 写 入 文件 , 即便 关闭 包含 程序 
输出 的 终端 窗口 ， 这 些 输 出 也 依然 存在 : 可 以 在 程序 结束 运行 后 查看 这 些 输 出 ,可 以 与 别人 分 享 
输出 文件 ， 还 可 以 编写 程序 来 将 这 些 输出 读 取 到 内 存 中 并 进行 处 理 。 


10.2.1 写 入 空 文件 

要 将 文本 写 入 文件 , 你 在 调用 open() 时 需要 提供 另 一 个 实 参 , 告诉 Python 你 要 写 入 打开 的 
文件 。 为 明白 其 中 的 工作 原理 ， 我 们 来 将 一 条 简单 的 消息 存储 到 文件 中 ， 而 不 是 将 其 打印 到 屏 
幕 上 : 


wrile filename = “PTogramming .txt 
message.py 
@ with open(filename, 'w') as file object: 
@ file object.write("I love programming.") 
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在 本 例 中 ， 调 用 open() 时 提供 了 两 个 实 参 ( 见 @ )。 第 一 个 实 参 也 是 要 打开 的 文件 的 名 称 。 
第 二 个 实 参 ('w' ) 告 诉 Python, 要 以 写 入 模式 打开 这 个 文件 。 打 开 文 件 时 , 可 指定 读 取 模式 ('r' )、 
写 入 模式 ('w' )、 附 加 模式 ('a' ) 或 读 写 模式 ('r+' )。 如 果 省 略 了 模式 实 参 ，Python 将 以 默认 
的 只 读 模 式 打开 文件 。 

如 果 要 写 入 的 文件 不 存在 ， 函 数 open() 将 自动 创建 它 。 然 而 ， 以 写 和 人 模式 ('w' ) 打开 文件 
时 千 万 要 小 心 ， 因 为 如 果 指 定 的 文件 已 经 存在 ，Python 将 在 返回 文件 对 象 前 清空 该 文件 的 内 容 。 


在 @ 处 ,使 用 文件 对 象 的 方法 write() 将 一 个 字符 串 写 和 文件。 这 个 程序 没有 终端 输出 ， 但 
如 果 打 开 文件 programming.txt， 将 看 到 其 中 包含 如 下 一 行内 容 : 


programming.txt I love programming. 


相 比 于 计算 机 中 的 其 他 文件 ， 这 个 文件 没有 什么 不 同 。 你 可 以 打开 它 、 在 其 中 输入 新 文本 、 
复制 其 内 容 、 将 内 容 粘 贴 到 其 中 ， 等 等 。 


注意 ”Python 只 能 将 字符 囊 写 入 文本 文件 。 要 将 数值 数据 存储 到 文本 文件 中 ， 必 须 先 使 用 函数 
str() 将 其 转换 为 字符 串 格 式 。 


10.2.2 写 入 多 行 


函数 write() 不 会 在 写 人 的 文本 末尾 添加 换行 符 ， 因 此 如 果 写 入 多 行 时 没有 指定 换行 符 ， 文 
件 看 起 来 可 能 不 是 你 希望 的 那样 : 


filename = 'programming.txt" 

with open(filename, 'w') as file object: 

file object.write("I love programming.") 

file object.write("I love creating new games.") 


如 果 你 打开 programming.txt， 将 发 现 两 行内 容 挤 在 一 起 : 


I love programming.1 love creating new games. 


要 让 每 个 字符 串 都 单独 占 一 行 ， 需要 在 方法 调用 write() 中 包含 换行 符 : 


filename = 'programming.txt" 


with open(filename, 'w') as file object: 
file object.write("I love programming.\n") 
file object.write("I love creating new games.\n") 


现在 ,输出 出 现在 不 同 的 行 中 : 
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I love programming. 
I love creating new games. 


像 显 示 到 终端 的 输出 一 样 ， 还 可 以 使 用 空格 、 制 表 符 和 空 行 来 设置 这 些 输出 的 格式 。 


10.2.3 ”附加 到 文件 


如 果 要 给 文件 添加 内 容 ， 而 不 是 覆盖 原 有 的 内 容 ,可 以 以 附加 模式 打开 文件 。 以 附加 模式 打 
开 文 件 时 , Python 不 会 在 返回 文件 对 象 前 清空 文件 的 内 容 , 而 是 将 写 人 文件 的 行 添 加 到 文件 未 尾 。 
如 果 指 定 的 文件 不 存在 ，Python 将 为 你 创建 一 个 空 文件 。 


下 面 来 修改 write_message.py, 在 既 有 文件 programming.txt 中 再 添加 一 些 你 酷爱 编程 的 原因 : 


write” filename = “programming .txt 
message.py 
@ with open(filename, 'a') as file object: 
@ file object.write("I also love finding meaning in large datasets.\n") 
file object.write("I love creating apps that can run in a browser.\n") 


在 @ 处 ， 打 开 文 件 时 指定 了 实 参 'a' ， 以 便 将 内 容 附加 到 文件 未 尾 ， 而 不 是 覆盖 文件 原来 的 
内 容 。 在 @ 处 ， 又 写 人 了 两 行 ， 它 们 被 添加 到 文件 programming.txt 末 尾 : 


programming.txt I love progr amming. 
I love creating new games . 
I also love finding meaning in large datasets. 
I love creating apps that can run in a browser. 


最 终 的 结果 是 ,文件 原来 的 内 容 还 在 ， 后面 则 是 刚 添加 的 内 容 。 


动手 试 一 试 
练习 10-3: 访客 编写 一 个 程序 ， 提 示 用 户 输 入 名 字 。 用 户 做 出 响应 后 ， 将 其 名 
字 写 入 文件 guest.txt 中 。 
练习 10-4: 访客 名 单 ” 编 写 一 个 while 循环 ， 提 示 用 户 输入 名 字 。 用 户 输入 名 字 


后 ， 在 屏幕 上 打印 一 句 问候 语 ， 并 将 一 条 到 访 记录 添加 到 文件 guest book.txt 中 。 确 保 
这 个 文件 中 的 每 条 记录 都 独占 一 行 。 

练习 10-5: 调查 编写 一 个 while 循环 ， 询 问 用 户 为 何 喜欢 编程 。 每 当 用 户 和 给 入 
一 个 原因 后 ， 都 将 其 添加 到 一 个 存储 所 有 原因 的 文件 中 。 
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10.3 “异常 


Python 使 用 称 为 异常 的 特殊 对 象 来 管理 程序 执行 期 间 发 生 的 错误 。 每 当 发 生 让 Python 不 知 
所 措 的 错误 时 ， 它 都 会 创建 一 个 异常 对 象 。 如 果 你 编写 了 处 理 该 异常 的 代码 ， 程 序 将 继续 运行 ; 
如 果 未 对 异常 进行 处 理 ， 程 序 将 停止 并 显示 traceback， 其 中 包含 有 关 异 常 的 报告 。 

异常 是 使 用 try-except 代码 块 处 理 的 。try-except 代码 块 让 Python 执行 指定 的 操作 ， 同 时 
告诉 Python 发 生 异 常 时 怎么 办 。 使 用 try-except 代码 块 时 ， 即便 出 现 异 常 , 程序 也 将 继续 运行 : 
显示 你 编写 的 友好 的 错误 消息 ， 而 不 是 令 用 户 迷 惑 的 traceback。 


10.3.1 处理 ZeroDivisionError 异常 


下 面 来 看 一 种 导致 Python 引发 异常 的 简单 错误 。 你 可 能 知道 ， 不 能 用 数 除 以 0， 但 还 是 让 
Python 这 样 做 : 


division print(5/0) 


calculator.py 


显然 ，Python 无 法 这 样 做 ， 因 此 你 将 看 到 一 个 traceback: 


Traceback (most recent call last): 
File "division calculator.py", line 1, in <module> 
print(5/0) 
@ 7eroDivisionError: division by zero 


在 上 述 traceback 中 ，@ 处 指出 的 错误 ZeroDivisionError 是 个 异常 对 象 。Python 无 法 按 你 的 
要 求 做 时 , 就 会 创建 这 种 对 象 。 在 这 种 情况 下 , Python 将 停止 运行 程序 , 并 指出 引发 了 哪 种 异常 ， 
而 我 们 可 根据 这 些 信 息 对 程序 进行 修改 。 下 面 来 告诉 Python，, 发 生 这 种 错误 时 怎么 办 。 这 样 ， 如 
果 再 次 发 生 此 类 错误 ， 我 们 就 有 备 无 患 了 。 


10.3.2 ”使 用 try-except 代码 块 


当 你 认为 可 能 会 发 生 错误 时 ， 可 编写 一 个 try-except 代码 块 来 处 理 可 能 引发 的 异常 。 你 让 
Python 尝试 运行 一 些 代码 ， 并 告诉 它 如 果 这 些 代 码 引发 了 指定 的 异常 该 怎么 办 。 


处 理 ZeroDivisionError 异常 的 try-except 代码 块 类 似 于 下 面 这 样 : 


try: 
print(5/0) 
except ZeroDivisionError: 
print("You can't divide by zero!") 


将 导致 错误 的 代码 行 print(5/0) 放 在 一 个 try 代码 块 中 。 如 果 try 代码 块 中 的 代码 运行 起 来 
没有 问题 ，Python 将 跳 过 except 代码 块 ; 如 果 try 代码 块 中 的 代码 导致 了 错误 ，Python 将 查找 
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与 之 匹配 的 except 代码 块 并 运行 其 中 的 代码 。 


在 本 例 中 ，try 代码 块 中 的 代码 引发 了 ZeroDivisionError 异常 ， 因 此 Python 查找 指出 了 该 
怎么 办 的 except 代码 块 ， 并 运行 其 中 的 代码 。 这 样 ， 用 户 看 到 的 是 一 条 友好 的 错误 消息 ， 而 不 


是 traceback: 


You can't divide by zero! 


如 果 try-except 代码 块 后 面 还 有 其 他 代码 ， 程 序 将 接着 运行 ， 因 为 已 经 告诉 了 Python 如 何 
处 理 这 种 错误 。 下 面 来 看 一 个 捕获 错误 后 程序 继续 运行 的 示例 。 
10.3.3 ”使 用 异常 避免 崩溃 


发 生 错 误 时 ,如 果 程 序 还 有 工作 尚未 完成 , 受 善 地 处 理 错误 就 尤其 重要 。 这 种 情况 经 常会 出 
现在 要 求 用 户 提供 输入 的 程序 中 ; 如 果 程 序 能 够 妥善 地 处 理 无 效 输入 , 就 能 再 提示 用 户 提 供 有 效 
输入 ， 而 不 至 于 骨 演 。 


下 面 来 创建 一 个 只 执行 除法 运算 的 简单 计算 器 : 


division print("Give me two numbers, and I'1] divide them.") 
calculator.py print("Enter 'q' to quit.") 


while True: 
© first number = input("\nFirst number: ") 
if first number == 'q : 
break 
@ second number = input("Second number: ") 
f second number == 'q" 
break 
(3 answer = int(first number) / int(second number) 
print(answer) 


在 @ 处 ,程序 提示 用 户 输入 一 个 数 ， 并 将 其 赋 给 变量 first_number。 如 果 用 户 输入 的 不 是 表 
示 退 出 的 q9， 就 再 提示 用 户 输入 一 个 数 ， 并 将 其 赋 给 变量 second_number ( 见 @ )。 接 下 来 ,计算 
这 两 个 数 的 商 ( 见 @ )。 该 程序 没有 采取 任何 处 理 错误 的 措施 ， 因 此 在 执行 除数 为 0 的 除法 运算 


时 ， 它 将 月 省 : 


Give me two numbers, and I 11 divide them. 
Enter 'q' to quit. 


First number: 5 
Second number: 0 
Traceback (most recent call last): 
File "division calculator.py", line 9, in <module> 
answer = int(first number) / int(second number) 
ZeroDivisionError: division by zero 
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程序 怖 泪 可 不 好 ， 但 让 用 户 看 到 traceback 也 不 是 个 好 主意 。 不 懂 技 术 的 用 户 会 被 搞 糊 涂 ， 
怀 有 恶意 的 用 户 还 会 通过 traceback 获悉 你 不 想 他 知道 的 信息 。 例 如 ， 他 将 知道 你 的 程序 文件 的 
名 称 , 还 将 看 到 部 分 不 能 正确 运行 的 代码 。 有 时 候 , 训练 有 素 的 攻击 者 可 根据 这 些 信息 判断 出 可 
对 你 的 代码 发 起 什么 样 的 攻击 。 


10.3.4 ”else 代码 块 

通过 将 可 能 引发 错误 的 代码 放 在 try-except 代码 块 中 ， 可 提高 程序 抵御 错误 的 能 力 。 错 误 
是 执行 除法 运算 的 代码 行 导致 的 ， 因 此 需要 将 它 放 到 try-except 代码 块 中 。 这 个 示例 还 包含 一 
个 else 代码 块 。 依 赖 try 代码 块 成 功 执行 的 代码 都 应 放 到 else 代码 块 中 : 


-- Snip-- 


while True: 
-- Snip-- 
if second number == 'q": 
break 
@ 二 了 
answer = int(first number) / int(second number) 
2 except ZeroDivisionError: 
print("You can't divide by 0!") 
3 else: 


print(answer) 


让 Python 尝试 执行 try 代码 块 中 的 除法 运算 ( 见 @ )， 这 个 代码 块 只 包含 可 能 导致 错误 的 代 
码 。 依 赖 try 代码 块 成 功 执行 的 代码 都 放 在 else 代码 块 中 。 在 本 例 中 ， 如 果 除 法 运算 成 功 ， 就 
使 用 else 代码 块 来 打印 结果 ( 见 @ )。 

except 代码 块 告 诉 Python， 出 现 ZeroDivisionError 异常 时 该 如 何 办 ( 见 @ )。 如 果 try 代码 
块 因 除 零 错误 而 失败 ， 就 打印 一 条 友好 的 消息 ,告诉 用 户 如 何 避 免 这 种 错误 。 程 序 继续 运行 ,用 
户 根 本 看 不 到 traceback: 


Give me two numbers, and I 1]11 divide them. 
Enter 'q' to quit. 


First number: 5 
Second number: 0 
You can't divide by 0! 


First number: 5 
Second number: 2 


2.5 


First number: q 


try-except-else 代码 块 的 工作 原理 大 致 如 下 。Python 尝试 执行 try 代码 块 中 的 代码 ， 只 有 
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可 能 引发 异常 的 代码 才 需 要 放 在 try 语句 中 。 有 时 候 ， 有 一 些 仅 在 try 代码 块 成 功 执行 时 才 需 要 
运行 的 代码 ， 这 些 代码 应 放 在 else 代码 块 中 。except 代码 块 告诉 Python， 如 果 尝 试 运行 try 代 
码 块 中 的 代码 时 引发 了 指定 的 异常 该 怎么 办 。 


通过 预测 可 能 发 生 错误 的 代码 ,可 编写 健壮 的 程序 。 它 们 即便 面临 无 效 数 据 或 缺少 资源 ,也 
能 继续 运行 ， 从 而 抵御 无 意 的 用 户 错误 和 恶意 的 攻击 。 


10.3.5 ”处理 FileNotFoundError 异常 
使 用 文件 时 , 一 种 常见 的 问题 是 找 不 到 文件 : 查找 的 文件 可 能 在 其 他 地 方 , 文件 名 可 能 不 正 
确 ， 或 者 这 个 文件 根本 就 不 存在 。 对 于 所 有 这 些 情 形 ， 都 可 使 用 try-except 代码 块 以 直观 的 方 
式 处 理 。 

我 们 来 尝试 读 取 一 个 不 存在 的 文件 。 下 面 的 程序 尝试 读 取 文件 alice.txt 的 内 容 ， 但 该 文件 没 
有 存储 在 alice.py 所 在 的 目录 中 : 


alice.py filename = "alice.txt' 


with open(filename, encoding="'utf-8') as f: 
contents = f.read() 


相 比 于 本 章 前 面 的 文件 打开 方式 ， 这 里 有 两 个 不 同 之 处 。 一 是 使 用 变量 f 来 表示 文件 对 象 ， 
这 是 一 种 常见 的 做 法 。 二 是 给 参数 encoding 指定 了 值 ， 在 系统 的 默认 编码 与 要 读 取 文 件 使 用 的 
编码 不 一 致 时 ， 必 须 这 样 做 。 


Python 无 法 读 取 不 存在 的 文件 ， 因 此 它 引 发 一 个 异常 : 


Traceback (most recent call last): 
File "alice.py", line 3, in <module> 
with open(filename, encoding="'utf-8') as f: 
FileNotFoundError: [Errno 2] No such file or directory: 'alice.txt' 


上 述 traceback 的 最 后 一 行 报 告 了 FileNotFoundError 异常 ,这 是 Python 找 不 到 要 打开 的 文件 
时 创建 的 异常 。 在 本 例 中 ， 这 个 错误 是 函数 open() 导 致 的 。 因 此 ， 要 处 理 这 个 错误 ， 必 须 将 try 
语句 放 在 包含 open() 的 代码 行 之 前 : 


filename = 'alice.txt' 


try: 
with open(filename, encoding="'utf-8') as f: 
contents = f.read() 
except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 
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在 本 例 中 ，try 代码 块 引发 了 FileNotFoundError 异常 ， 因 此 Python 找到 与 该 错误 匹配 的 
except 代码 块 ， 并 运行 其 中 的 代码 。 最 终 的 结果 是 显示 一 条 友好 的 错误 消息 ， 而 不 是 traceback: 


Sorry, the file alice.txt does not exist. 


如 果 文 件 不 存在 ,这 个 程序 就 什么 都 做 不 了 ,错误 处 理 代码 也 意义 不 大 。 下 面 来 扩展 这 个 示 
例 ， 看 看 在 你 使 用 多 个 文件 时 ， 异 常 处 理 可 提供 什么 样 的 帮助 。 


10.3.6 ”分 析 文 本 


你 可 以 分 析 包 含 整 本 书 的 文本 文件 。 很 多 经 典 文学 作品 都 是 简单 以 文本 文件 的 形式 提供 的 ， 
因为 它们 不 受 版 权限 制 。 本 节 使 用 的 文本 来 自古 登 保 计划 , 该 计划 提供 了 一 系列 不 受 版 权限 制 的 
文学 作品 。 如 果 你 要 在 编程 项 目 中 使 用 文学 文本 ， 这 是 一 个 很 不 错 的 资源 。 

下 面 来 提取 童话 《爱丽 丝 漫游 奇 境 记 》( hlice in Wonderland ) 的 文本 ， 并 尝试 计算 它 包 含 多 
少 个 单词 。 我 们 将 使 用 方法 split()， 它 能 根据 一 个 字符 串 创建 一 个 单词 列表 。 下 面 是 对 只 包含 
童话 名 "Alice in Wonderland" 的 字符 串 调 用 方法 split() 的 结 


>>> title = "Alice in Wonderland" 
>>> title.split() 
['Alice', 'in', 'Wonderland'] 


方法 split() 以 空格 为 分 隔 符 将 字符 串 分 拆 成 多 个 部 分 ,并 将 这 些 部 分 都 存储 到 一 个 列表 中 。 
结果 是 一 个 包含 字符 串 中 所 有 单词 的 列表 , 虽然 有 些 单词 可 能 包含 标点 。 为 计算 《爱丽 丝 漫 游 奇 
境 记 》 包 含 多 少 个 单词 ， 我 们 将 对 整 篇 小 说 调用 split()， 再 计算 得 到 的 列表 包含 多 少 个 元 素 ， 
从 而 确定 整 篇 童话 大 致 包含 多 少 个 单词 : 


filename = 'alice.txt' 


try: 
with open(filename, encoding="'utf-8') as f: 
contents = f.read() 
except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 
else: 
# 计算 该 文件 大 致 包含 多 少 个 单词 。 
@ words = contents.split() 
@ num words = len(words) 
[3) print(f"The file {filename} has about {num words} words.") 


我 们 将 文件 alice.txt 移 到 了 正确 的 目录 中 ， 让 try 代码 块 能 够 成 功 执行 。 在 @ 人 处 ， 对 变量 
contents( 它 现 在 是 一 个 长 长 的 字符 串 ， 包 含 童 话 《 爱 丽 丝 漫游 奇 境 记 》 的 全 部 文本 ) 调用 方法 
split(), 以 生成 一 个 列表 ， 其 中 包含 这 部 童话 中 的 所 有 单词 。 使 用 len() 来 确定 这 个 列表 的 长 度 
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时 ， 就 能 知道 原始 字符 串 大 致 包含 多 少 个 单词 了 ( 见 @ )。 在 @ 处 ， 打 印 一 条 消息 ， 指 出 文件 包 
含 多 少 个 单词 。 这 些 代码 都 放 在 else 代码 块 中 ， 因 为 仅 当 try 代码 块 成 功 执行 时 才 执 行 它们 。 
输出 指出 了 文件 alice.txt 包含 多 少 个 单词 : 


The file alice.txt has about 29465 words. 


这 个 数 稍 大 一 点 , 因为 使 用 的 文本 文件 包含 出 版 商 提供 的 额外 信息 , 但 还 是 成 功 估算 出 了 童 
话 《爱丽 丝 漫游 奇 境 记 》 的 篇 幅 。 


10.3.7 ”使 用 多 个 文件 


下 面 多 分 析 几 本 书 。 这 此 之 前 ， 先 将 这 个 程序 的 大 部 分 代码 移 到 一 个 名 为 count_words() 的 
函数 中 。 这 样 ， 对 多 本 书 进 行 分 析 时 将 更 容易 : 


word_count:py def count words(filename): 
© "" "计算 一 个 文件 大 致 包含 多 少 个 单词 。""" 

try: 

with open(filename, encoding="'utf-8') as f: 
contents = f.read() 

except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 

else: 
words = contents.split() 
num words = len(words) 
print(f"The file {filename} has about {num words} words.") 


filename = "alice.txt" 
count words (filename) 


这 些 代码 大 多 与 原来 一 样 ， 只 是 移 到 了 函数 count_words() 中 ， 并 增加 了 缩 进 量 。 修 改 程序 的 
同时 更 新 注释 是 个 不 错 的 习惯 ,因此 我 们 将 注释 改 成 文档 字符 串 ， 并 稍微 调整 了 一 下 措辞 ( 见 @ )。 

现在 可 以 编写 一 个 简单 的 循环 , 计算 要 分 析 的 任何 文本 包含 多 少 个 单词 了 。 为 此 , 将 要 分 析 
的 文件 的 名 称 存储 在 一 个 列表 中 ， 然 后 对 列表 中 的 每 个 文件 调用 count_words()。 我 们 将 尝试 计 
算 《 爱 丽 丝 漫游 奇 境 记 》《 悉 达 多 》( Siddhartha )、《 白 鲸 》( Moby Dick) 和 《小 妇 人 》( Little 
Women ) 分 别 包含 多 少 个 单词 ， 它 们 都 不 受 版 权限 制 。 我 故意 没有 将 siddhartha.txt 放 到 
word_count.py 所 在 的 目录 中 ， 从 而 展示 该 程序 在 文件 不 存在 时 应 对 得 有 多 出 色 : 


def count words(filename): 
-- Snip-- 


filenames = ["'alice.txt', 'siddhartha.txt', 'moby dick.txt', 'little women.txt'] 
for filename in filenames: 
count words(filename) 
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文件 siddhartha.txt 不 存在 ， 但 这 丝毫 不 影响 该 程序 处 理 其 他 文件 : 


The file alice.txt has about 29465 words . 

Sorry, the file siddhartha.txt does not exist. 
The file moby dick.txt has about 215830 words. 
The file little women.txt has about 189079 words. 


在 本 例 中 ,使 用 try-except 代码 块 提供 了 两 个 重要 的 优点 : 避免 用 户 看 到 traceback， 以 及 
让 程序 继续 分 析 能 够 找到 的 其 他 文件 。 如 果 不 捕获 因 找 不 到 siddhartha.txt 而 引发 的 
FileNotFoundError 异常 ， 用 户 将 看 到 完整 的 traceback， 而 程序 将 在 尝试 分 析 《 悉 达 多 》 后 停止 
运行 。 它 根本 不 会 分 析 《 白 鲸 》 和 《小 妇 人 》。 


10.3.8 ”静默 失败 


在 前 一 个 示例 中 ,我 们 告诉 用 户 有 一 个 文件 找 不 到 。 但 并 非 每 次 捕获 到 异常 都 需要 告诉 用 户 ， 
有 了 时候 你 希望 程序 在 发 生 异 常 时 保持 静默 ,就 像 什么 都 没有 发 生 一 样 继续 运行 。 要 让 程序 静默 失 
败 ,可 像 通常 那样 编写 try 代码 块 ,但 在 except 代码 块 中 明确 地 告诉 Python 什么 都 不 要 做 .Python 
有 一 个 pass 语句 ， 可 用 于 让 Python 在 代码 块 中 什么 都 不 要 做 : 


def count words(filename): 
"" "计算 一 个 文件 大 致 包含 多 少 个 单词 。""" 
try: 
-- SNnip-- 
except FileNotFoundError: 
@ pass 
else: 
-- Snip-- 


filenames = ['alice.txt', 'siddhartha.txt', 'moby dick.txt', 'little women.txt'] 
for filename in filenames: 
count words(filename) 


相 比 于 前 一 个 程序 ， 这 个 程序 唯一 的 不 同 之 处 是 @ 人 处 的 pass 语句 。 现 在 ， 出 现 FileNot- 
FoundError 异常 时 ， 将 执行 except 代码 块 中 的 代码 ， 但 什么 都 不 会 发 生 。 这 种 错误 发 生 时 ， 不 
会 出 现 traceback, 也 没有 任何 输出 。 用 户 将 看 到 存在 的 每 个 文件 包含 多 少 个 单词 , 但 没有 任何 迹 
象 表 明 有 一 个 文件 未 找到 ; 


The file alice.txt has about 29465 words . 
The file moby dick.txt has about 215830 words. 
The file little women.txt has about 189079 words. 


pass 语句 还 充当 了 占 位 符 , 提醒 你 在 程序 的 某 个 地 方 什 么 都 没有 做 , 并 且 以 后 也 许 要 在 这 里 
做 些 什么 。 例 如 ， 在 这 个 程序 中 ,我 们 可 能 决定 将 找 不 到 的 文件 的 名 称 写 入 文件 missing_files.txt 
中 。 用 户 看 不 到 这 个 文件 ， 但 我 们 可 以 读 取 它 ， 进 而 处 理 所 有 找 不 到 文件 的 问题 。 
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10.3.9 决定 报告 哪些 错误 


该 在 什么 情况 下 向 用 户 报告 错误 ? 又 该 在 什么 情况 下 静默 失败 呢 ? 如 果 用 户 知道 要 分 析 哪 
些 文件 , 他 们 可 能 希望 在 有 文件 却 没有 分 析 时 出 现 一 条 消息 来 告知 原因 。 如 果 用 户 只 想 看 到 结果 ， 
并 不 知道 要 分 析 哪 些 文件 , 可 能 就 无 须 在 有 些 文件 不 存在 时 告知 他 们 。 向 用 户 显示 他 不 想 看 到 的 
言 息 可 能 会 降低 程序 的 可 用 性 .Python 的 错误 处 理 结构 让 你 能 够 细致 地 控制 与 用 户 分 享 错误 信息 
的 程度 ， 要 分 享 多 少 信息 由 你 决定 。 
编写 得 很 好 且 经 过 详尽 测试 的 代码 不 容易 出 现 内 部 错误 , 如 语法 或 逻辑 错误 , 但 只 要 程序 依 
赖 于 外 部 因素 ， 如 用 户 输入 、 存 在 指定 的 文件 、 有 网 络 链接 ， 就 有 可 能 出 现 异 常 。 和 凭借 经 验 可 判 
断 该 在 程序 的 什么 地 方 包含 异常 处 理 块 ， 以 及 出 现 错误 时 该 向 用 户 提供 多 少 相 关 的 信息 。 


动手 试 一 斌 

练习 10-6: 加 法 运算 提示 用 户 提 供 数 值 输入 时 ， 常 出 现 的 一 个 问题 是 ， 用 户 提 
供 的 是 文本 而 不 是 数 。 在 此 情况 下 ， 当 你 尝试 将 输入 转换 为 整数 时 , 将 引发 ValueError 
异常 。 编写 一 个 程序 提示 用 户 输入 两 个 数 ， 再 将 其 相 加 并 打印 结果 。 在 用 户 输入 的 任 
何 一 个 值 不 是 数 时 都 捕获 ValueError 异常 ， 并 打印 一 条 友好 的 错误 消息 。 对 你 编写 的 
程序 进行 测试 : 先 输入 两 个 数 ， 再 输入 一 些 文本 而 不 是 数 。 

练习 10-7: 加 法 计算 器 ”将 为 完成 练习 10-6 而 编写 的 代码 放 在 一 个 while 循环 中 ， 
让 用 户 犯 错 (输入 的 是 文本 而 不 是 数 ) 后 能 够 继续 输入 数 。 

练习 10-8: 猫 和 狗 创建 文件 cats.txt 和 dogs.txt， 在 第 一 个 文件 中 至 少 存储 三 只 猫 
的 名 字 ， 在 第 二 个 文件 中 至 少 存储 三 条 狗 的 名 字 。 编 写 一 个 程序 ， 尝 试 读 取 这 些 文件 ， 
并 将 其 内 容 打 印 到 屏幕 上 。 将 这 些 代码 放 在 一 个 try-except 代码 块 中 ， 以 便 在 文件 不 
存在 时 捕获 FileNotFound 错误 ， 并 显示 一 条 友好 的 消息 。 将 任意 一 个 文件 移 到 另 一 个 
地 方 ， 并 确认 except 代码 块 中 的 代码 将 正确 执行 。 

练习 10-9: 静默 的 猫 和 狗 修改 你 在 练习 10-8 中 编写 的 except 代码 块 ， 让 程序 在 
任意 文件 不 存在 时 静默 失败 。 

练习 10-10: 常见 单词 访问 古 登 堡 计划 ， 找 一 些 你 想 分 析 的 图 书 。 下 载 这 些 作品 
的 文本 文件 或 将 浏览 器 中 的 原始 文本 复制 到 文本 文件 中 。 

可 以 使 用 方法 count() 来 确定 特定 的 单词 或 短语 在 字符 串 中 出 现 了 多 少 次 。 例 如 ， 
下 面 的 代码 计算 'Tow' 在 一 个 字符 串 中 出 现 了 多 少 次 : 


>>> line = "Row, row, row your boat" 
>>> line.count('row') 

2 

>>> line.lower().count('row') 

B 
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请 注意 ， 通 过 使 用 lower() 将 字符 囊 转换 为 小 写 ， 可 捕捉 要 查找 单词 的 所 有 格式 ， 
而 不 管 其 大 小 写 如 何 。 
编写 一 个 程序 ， 它 读 取 你 在 古 登 堡 计划 中 获取 的 文件 ， 并 计算 单词 'the' 在 每 个 文 


件 中 分 别 出 现 了 多 少 次 。 这 里 计算 得 到 的 结果 并 不 准确 ， 因 为 将 诸如 'then' 和 'there' 
等 单词 也 计算 在 内 了 。 请 尝试 计算 'the ' ( 包含 空格 ) 出 现 的 次 数 ， 看 看 结果 相差 多 少 。 


10.4 存储 数据 


很 多 程序 都 要 求 用 户 输入 某 种 信息 , 如 让 用 户 存储 游戏 首选 项 或 提供 要 可 视 化 的 数据 。 不 管 
关注 点 是 什么 ,程序 都 把 用 户 提供 的 信息 存储 在 列表 和 字典 等 数据 结构 中 。 用 户 关闭 程序 时 , 几 
平 总 是 要 保存 他 们 提供 的 信息 。 一 种 简单 的 方式 是 使 用 模块 json 来 存储 数据 。 


模块 json 让 你 能 够 将 简单 的 Python 数据 结构 转 储 到 文件 中 ， 并 在 程序 再 次 运行 时 加 载 该 文 
件 中 的 数据 。 你 还 可 以 使 用 json 在 Python 程序 之 间 分 享 数 据 。 更 重要 的 是 ，JSON 数据 格式 并 
非 Python 专用 的 , 这 让 你 能 够 将 以 JSON 格式 存储 的 数据 与 使 用 其 他 编程 语言 的 人 分 享 。 这 是 一 
种 轻便 而 有 用 的 格式 ， 也 易于 学 习 。 


注意 JSON ( JavaScript Object Notation ) 格式 最 初 是 为 JavaScript 开发 的 ， 但 随后 成 了 一 种 常 
见 格式 ， 被 包括 Python 在 内 的 众多 语言 采用 。 


10.4.1 使 用 json.dump() 和 json.1oad() 
我 们 来 编写 一 个 存储 一 组 数 的 简短 程序 , 再 编写 一 个 将 这 些 数 读 取 到 内 存 中 的 程序 。 第 一 个 
程序 将 使 用 json.dump() 来 存储 这 组 数 ， 而 第 二 个 程序 将 使 用 json.1o0ad()。 


函数 json.dump() 接 受 两 个 实 参 : 要 存储 的 数据 ， 以 及 可 用 于 存储 数据 的 文件 对 象 。 下 面 演 
示 了 如 何 使 用 json.dump() 来 存储 数字 列表 : 


number import json 
writer.py 
numbers = [2，3，5，7，11，13] 


@ filename = 'numbers.json’ 
@ with open(filename, 'w') as f: 
(3) json.dump(numbers, f) 


先导 入 模块 json, 再 创建 一 个 数字 列表 。 在 @ 处 , 指定 了 要 将 该 数字 列表 存储 到 哪个 文件 中 。 
通常 使 用 文件 扩展 名 .json 来 指出 文件 存储 的 数据 为 JSON 格式 。 接 下 来 ,以 写 人 模式 打开 这 个 文 


10.4 存储 数据 183 


件 , 让 json 能 够 将 数据 写 人 其 中 ( 见 @@ ), 在 @ 人 处, 使 用 函数 json.dump() 将 数字 列表 存储 到 文件 
numbers.json 中 。 

这 个 程序 没有 输出 ,但 可 以 打开 文件 numbers.json 来 看 看 内 容 。 数 据 的 存储 格式 与 Python 
中 一 样 : 


[2，3，5，7，11，13] 


下 面 再 编写 一 个 程序 ， 使 用 json.1oad() 将 列表 读 取 到 内 存 中 : 


number import json 

reader.py 
@ filename = 'numbers.json’ 
@ with open(filename) as f: 
(3 numbers = json.1load(f) 


print(numbers) 


在 @ 处 , 确保 读 取 的 是 前 面 写 人 的 文件 。 这 次 以 读 取 方式 打开 该 文件 ， 因为 Python 只 需要 
读 取 它 ( 见 @ )。 在 @ 处 ,使 用 也 数 json.1oad() 加 载 存储 在 numbers.json 中 的 信息 ， 并 将 其 赋 
给 变量 numbers。 最 后 ， 打 印 恢 复 的 数字 列表 ， 看 看 是 否 与 number_ writer.py 中 创建 的 数字 列 10 
表 相 同 : 


[2，3，5，7，11，13] 


这 是 一 种 在 程序 之 间 共 享 数据 的 简单 方式 。 


10.4.2 ”保存 和 读 取 用 户 生 成 的 数据 


使 用 json 保存 用 户 生成 的 数据 大 有 神 益 ， 因 为 如 果 不 以 某 种 方式 存储 ， 用 户 的 信息 会 在 程 
序 停止 运行 时 丢失 。 下 面 来 看 一 个 这 样 的 例子 : 提示 用 户 首次 运行 程序 时 输入 自己 的 名 字 ， 并 在 
再 次 运行 程序 时 记 住 他 。 

先 来 存储 用 户 的 名 字 : 


remember_ import json 


me.py 
@ username = input("What is your name? ") 


filename = 'username.json’ 
with open(filename, 'w') as f: 
© json.dump(username, f) 
【3) print(f"We'll remember you when you come back, {username}!") 


在 @ 处 ,提示 输入 用 户 名 并 将 其 赋 给 一 个 变量 。 接 下 来 ， 调 用 json.dump()， 并 将 用 户 名 和 
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一 个 文件 对 象 传递 给 它 ， 从 而 将 用 户 名 存储 到 文件 中 〈 见 @ )。 然 后 ， 打 印 一 条 消息 ， 指 出 存储 


了 用 户 输入 的 信息 ( 见 @ ): 


What is your name? Eric 
We'll remember you when you come back, 


Eric! 


现在 再 编写 一 个 程序 ， 向 已 存储 了 和 名字 的 用 户 发 出 问候 : 


greet userpy import json 
filename = "username.json’ 
with open(filename) as f: 


@ username = json.1oad(f) 
2 print(f"Welcome back, {username}!" 


) 


在 @ 处 , 使 用 json.1o0ad() 将 存储 在 


username.json 中 的 信息 读 取 到 变量 username 中 。 恢复 用 


户 名 后 ， 就 可 以 欢迎 用 户 回来 了 ( 见 @ ): 


Welcome back, Eric! 


需要 将 这 两 个 程序 合并 到 一 个 程序 


(remember_ me.py ) 中 。 这 个 程序 运行 时 , 将 尝试 从 文件 


username.json 中 获取 用 户 名 。 因 此 ， 首 先 编写 一 个 尝试 恢复 用 户 名 的 try 代码 块 。 如 果 这 个 文件 
不 存在 ， 就 在 except 代码 块 中 提示 用 户 输 入 用 户 名 ， 并 将 其 存储 到 username.json 中 ， 以 便 程序 


再 次 运行 时 能 够 获取 : 


remember_ import json 
me.py 
# 如 果 以 前 存储 了 用 户 名 ， 就 加 载 它 。 
# 否则 ， 提 示 用 户 输入 用 户 名 并 存储 它 。 
filename = “Usezname.json 
try: 
with open(filename) as f: 
username = json.1oad(f) 
except FileNotFoundError: 
username = input("What is your nam 
with open(filename, 'w') as f: 
json.dump(username, f) 


OOOO® 


e? Dp 


print(f"We'll remember you when you come back, {username}!") 


else: 
print(f"Welcome back, {username}!" 


) 


这 里 没有 任何 新 代码 ， 只 是 将 前 两 个 示例 的 代码 合并 到 了 一 个 程序 中 。 在 @ 处 ,尝试 打开 文 


件 username.json。 如 果 该 文件 存在 ， 就 ; 


符 其 中 的 用 户 名 读 取 到 内 存 中 ( 见 @ )， 再 执行 else 代码 


块 ， 打 印 一 条 欢迎 用 户 回 来 的 消息 。 用 户 首次 运行 该 程序 时 ,文件 username.json 不 存在 ,将 


引发 FileNotFoundError 异常 ( 见 @ )。 


因此 Python 将 执行 except 代码 块 ， 提 示 用 户 输入 用 户 名 
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( 见 @ )， 再 使 用 json.dump() 存 储 该 用 户 名 并 打印 一 句 问 候 语 ( 见 @ )。 
无 论 执行 的 是 except 还 是 else 代码 块 ， 都 将 显示 用 户 名 和 合适 的 问候 语 。 如 果 这 个 程序 是 
首次 运行 ， 输 出 将 如 下 : 


What is your name? Eric 
We'll remember you when you come back, Eric! 


否则 ， 输 出 将 如 下 : 


Welcome back, Eric! 


这 是 程序 之 前 至 少 运 行 了 一 次 时 的 输出 。 


10.4.3 ” 重 构 
你 经 常会 遇 到 这 样 的 情况 : 代码 能 够 正确 地 运行 , 但 通过 将 其 划分 为 一 系列 完成 具体 工作 的 
函数 ， 还 可 以 改进 。 这 样 的 过 程 称 为 重 构 。 重 构 让 代码 更 清晰 、 更 易于 理解 、 更 容易 扩展 。 
要 重 构 remember me.py， 可 将 其 大 部 分 逻辑 放 到 一 个 或 多 个 函数 中 。remember_me.py 的 重 


点 是 问候 用 户 ， 因 此 将 其 所 有 代码 都 放 到 一 个 名 为 greet_user() 的 函数 中 : 


remember import json 


me.py 
def greet user(): 
oO Wu 问候 用 户 ， 并 指出 其 名 字 。""" 
filename = 'username.json’ 
try: 


with open(filename) as f: 
username = json.load(f) 
except FileNotFoundError: 
username = input("What is your name? ") 
with open(filename, 'w') as f: 
json.dump(username, f) 
print(f"We'll remember you when you come back, {username}!") 


else: 
print(f"Welcome back, {username}!") 


greet user() 


考虑 到 现在 使 用 了 一 个 函数 , 我 们 删除 原 注释 , 转 而 使 用 一 个 文档 字符 串 来 指出 程序 的 作用 
( 见 @ )。 这 个 程序 更 加 清晰 ,但 函数 greet_user() 所 做 的 不 仅仅 是 问候 用 户 ， 还 在 存储 了 用 户 名 


时 获取 它 、 在 没有 存储 用 户 名 时 提示 用 户 输入 。 
下 面 来 重 构 greet_user(), 减少 其 任务 。 为 此 ,首先 将 获取 已 存储 用 户 名 的 代码 移 到 另 一 个 
函数 中 : 
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import json 


def get stored username(): 


def 


""" 如 果 存 储 了 用 户 名 ,就 获取 它 。""" 
filename = 'username.json’ 
try: 

with open(filename) as f: 

username = json.load(f) 

except FileNotFoundError: 

return None 
else: 

return username 


greet user(): 

""" 间 候 用 户 ， 并 指出 其 名 字 。"" 
username = get stored username() 
if username: 


print(f"Welcome back, {username}!") 


else: 


username = input("What is your name? " 


filename = 'username.json’ 
with open(filename, 'w') as f: 
json.dump(username, f) 


print(f"We'll remember you when you come back, {username}!") 


greet user() 


新 增 的 函数 get_stored_username() 目 标明 确 , @ 处 的 文档 字符 串 指出 了 这 一 点 。 如果 存储 了 


用 户 名 ,该 函数 就 获取 并 返回 它 ; 如 果 文 件 username.json 不 存在 ,该 函数 就 返回 None ( 见 @ )。 
这 是 一 种 不 错 的 做 法 : 函数 要 么 返回 预期 的 值 , 要 么 返回 None。 这 让 我 们 能 够 使 用 函数 的 返回 值 


做 简单 的 测试 。 在 @ 处 ， 如 果 成 功 地 获取 了 用 户 名 ， 就 打印 一 条 


日 


用 户 输入 用 户 名 。 


还 需要 重 构 greet_user() 中 的 另 一 个 代码 块 , 将 没有 存储 用 户 名 时 提示 用 户 输入 的 代码 放 在 
一 个 独立 的 函数 中 : 


欢迎 用 户 回来 的 消息 ,否则 提示 


import json 


def 


def 


def 


get stored username(): 
""" 如 果 存 储 了 用 户 名 ， 就 获取 它 。""" 
-- SNip-- 


get new username(): 
"" "提示 用 户 输 入 用 户 名 。""" 


username = input("What is your name? ") 


filename = 'username.json’ 
with open(filename, 'w') as f: 
json.dump(username, f) 
return username 


greet user(): 
"" "问候 用 户 ， 并 指出 其 名 字 。 "” 
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username = get stored username() 
if username: 
print(f"Welcome back, {username}!") 
else: 
username = get new username() 
print(f"We'll remember you when you come back, {username}!") 


greet user() 


在 remember_me.py 的 这 个 最 终 版 本 中 ， 每 个 函数 都 执行 单一 而 清晰 的 任务 。 我 们 调用 
greet_user() ， 它 打印 一 条 合适 的 消息 : 要 么 欢迎 老 用 户 回来 ,要么 问候 新 用 户 。 为 此 ， 它 首先 
调用 get_stored username()， 该 函数 只 负责 获取 已 存储 的 用 户 名 ( 如 果 存 储 了 的 话 )。 最 后 在 必 
要 时 调用 get_new_username() ， 该 函数 只 负责 获取 并 存储 新 用 户 的 用 户 名 。 要 编写 出 清晰 而 易于 
维护 和 扩展 的 代码 ， 这 种 划分 必 不 可 少 。 


动手 试 一 斌 

练习 10-11: 喜欢 的 数 编写 一 个 程序 ， 提 示 用 户 输入 喜欢 的 数 ， 并 使 用 json.dump() 
将 这 个 数 存储 到 文件 中 。 再 编写 一 个 程序 , 从 文件 中 读 取 这 个 值 , 并 打印 如 下 所 示 的 消息 。 

Iknow your favorite number! It's 

练习 10-12: 记 住 喜欢 的 数 ”将 练习 10-11 中 的 程序 合 二 为 一 。 如 果 存 储 了 用 户 喜 
欢 的 数 ， 就 向 用 户 显示 它 ， 否 则 提示 用 户 输入 喜欢 的 数 并 将 其 存储 到 文件 中 。 运 行 这 个 


程序 两 次 ， 看 看 它 能 否 像 预期 的 那样 工作 。 


练习 10-13 : 验证 用 户 ”最 后 一 个 remember me.py 版 本 假设 用 户 要 么 已 输入 用 户 名 ， 
要 么 是 首次 运行 该 程序 。 我 们 应 该 修改 这 个 程序 ， 以 防 当前 用 户 并 非 上 次 运行 该 程序 的 
周记 8 

为 此 , 在 greet user() 中 打印 欢迎 用 户 回 来 的 消息 前 ,询问 他 用 户 名 是 否 正确 。 如 
果 不 对 ， 就 调用 get_new username() 让 用 户 输 入 正确 的 用 户 名 。 


10.5 ”小结 


在 本 章 中 ,你 学 习 了 : 如 何 使 用 文件 ; 如 何 一 次 性 读 取 整个 文件 ， 以 及 如 何以 每 次 一 行 的 方 
式 读 取 文件 的 内 容 ; 如 何 写 入 文件 ， 以 及 如 何 将 文本 附加 到 文件 末尾 ; 什么 是 异常 以 及 如 何 处 理 
程序 可 能 引发 的 异常 ;， 如何 存储 Python 数据 结构 ， 以 保存 用 户 提 供 的 信息 ， 避 免 用 户 每 次 运行 
程序 时 都 需要 重新 提供 。 

在 第 11 章 中 ， 你 将 学 习 高 效 的 代码 测试 方式 。 这 可 帮助 你 确定 代码 正确 无 误 ， 以 及 发 现 扩 
展现 有 程序 时 可 能 引入 的 bug。 


测试 代码 


编写 函数 或 类 时 ,还 可 为 其 编写 测试 。 通过 测试 ， 可 确定 代码 面 
对 各 种 输入 都 能 够 按 要 求 的 那样 工作 。 测试 让 你 深信 ,即便 有 更 多 人 
使 用 你 的 程序 ， 它 也 能 正确 地 工作 。 在 程序 中 添加 新 代码 时 ， 也 可 以 
对 其 进行 测试 ， 确 认 不 会 破坏 程序 既 有 的 行为 。 程 序 员 都 会 犯错 ， 因 
此 每 个 程序 员 都 必须 经 常 测试 其 代码 ， 在 用 户 发 现 问题 前 找 出 它们 。 

在 本 章 中 ， 你 将 学 习 如 何 使 用 Python 模块 unittest 中 的 工具 来 
测试 代码 , 还 将 学 习 编 写 测试 用 例 , 核实 一 系列 输入 都 将 得 到 预期 的 
输出 。 你 将 看 到 测试 通过 了 是 什么 样子 ， 测 试 未 通过 又 是 什么 样子 ， 
还 将 知道 测试 未 通过 如 何 有 助 于 改进 代码 。 你 将 学 习 如 何 测试 函数 和 类 ， 并 将 知道 该 为 项 目 
编写 多 少 个 测试 。 


ol 
视频 讲解 


11.1 测试 函数 


要 学 习 测 试 ， 必 须 有 要 测试 的 代码 。 下 面 是 一 个 简单 的 函数 ， 它 接受 名 和 姓 并 返回 整洁 的 
姓名 : 


name def get formatted name(first, last): 
function.py """ 生 成 整洁 的 姓名 。""" 
full name = f"{first} {last}" 
return full name.title() 


函数 get_formatted_name() 将 名 和 姓 合 并 成 姓名 : 在 名 和 姓 之 间 加 上 一 个 空格 并 将 其 首 字 母 
大 写 ， 再 返回 结果 。 为 核实 get_formatted_name() 像 期 望 的 那样 工作 ， 我 们 来 编写 一 个 使 用 该 函 
数 的 程序 。 程 序 names.py 让 用 户 输入 名 和 姓 ， 并 显示 整洁 的 姓名 : 


names.py from name function import get formatted name 


print("Enter 'q' at any time to quit.") 
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while True: 
first = input("\nPlease give me a first name: ") 
if first == "'q": 
break 
last = input("Please give me a last name: ") 
if last == 'q": 
break 


formatted name = get formatted name(first, last) 
print(f"\tNeatly formatted name: {formatted name}.") 


这 个 程序 从 name function.py 中 导入 get formatted _name()。 用 户 可 输入 一 系列 名 和 姓 ， 并 
看 到 格式 整洁 的 姓名 : 


Enter 'q' at any time to quit. 


局 


ease give me a first name: janis 
ease give me a last name: joplin 
Neatly formatted name: Janis Joplin. 


局 


全 


ease give me a first name: bob 
ease give me a last name: dylan 
Neatly formatted name: Bob Dylan. 


局 


Please give me a first name: q 


从 上 述 输出 可 知 ， 合 并 得 到 的 姓名 正确 无 误 。 现 在 假设 要 修改 get_formatted_name(), 使 其 
还 能 够 处 理 中 间 名 。 这 样 做 时 ， 要 确保 不 破坏 这 个 函数 处 理 只 含有 名 和 姓 的 姓名 的 方式 。 为 此 ， 
可 在 每 次 修改 get_formatted_name() 后 都 进行 测试 ， 运行 程序 names.py， 并 输入 像 Janis Joplin 
这 样 的 姓名 。 不 过 这 太 烦 琐 了 。 所 幸 Python 提供 了 一 种 自动 测试 函数 输出 的 高 效 方式 。 倘 若 对 
get_formatted_name() 进 行 自动 测试 ， 就 能 始终 确信 当 提 供 测试 过 的 姓名 时 ， 该 函数 都 能 正确 
工作 。 


11.1.1 单元 测试 和 测试 用 例 


Python 标准 库 中 的 模块 unittest 提供 了 代码 测试 工具 。 单 元 测试 用 于 核实 函数 的 某 个 方面 
没有 问题 。 测 试用 例 是 一 组 单元 测试 ,它们 一 道 核实 函数 在 各 种 情形 下 的 行为 都 符合 要 求 。 良 好 
的 测试 用 例 考虑 到 了 函数 可 能 收 到 的 各 种 输入 , 包含 针对 所 有 这 些 情形 的 测试 。 全 覆盖 的 测试 用 
例 包 含 一 整套 单元 测试 , 涵盖 了 各 种 可 能 的 函数 使 用 方式 。 对 于 大 型 项 目 , 要 进行 全 覆盖 测试 可 
能 很 难 。 通常 , 最 初 只 要 针对 代码 的 重要 行为 编写 测试 即 可 , 等 项 目 被 广泛 使 用 时 再 考虑 全 覆盖 。 


11.1.2 ”可 通过 的 测试 
你 需要 一 段 时 间 才 能 习惯 创建 测试 用 例 的 语法 , 但 创建 测试 用 例 之 后 , 再 添加 针对 函数 的 单 
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元 测试 就 很 简单 了 。 要 为 函数 编写 测试 用 例 ， 可 先导 入 模块 unittest 和 要 测试 的 函数 ， 再 创建 
一 个 继承 unittest.TestCase 的 类 ， 并 编写 一 系列 方法 对 函数 行为 的 不 同方 面 进行 测试 。 

下 面 的 测试 用 例 只 包含 一 个 方法 ， 它 检查 函数 get_formatted_name() 在 给 定名 和 姓 时 能 否 正 
确 工作 : 


test name ”import unittest 
function.py from name function import get formatted name 


@ class NamesTestCase(unittest.TestCase): 
"测试 name_function.py。""" 


def test first last name(self): 
"" "能够 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 吗 ?""" 


© formatted name = get formatted name('janis', 'joplin') 
(3 self.assertEqual(formatted name, 'Janis Joplin') 
@ if name == ' main 


unittest.main() 


首先 ， 导入 了 模块 unittest 和 要 测试 的 函数 get_formatted_name()。 在 @ 处 , 创建 了 一 个 名 
为 NamesTestCase 的 类 ， 用 于 包含 一 系列 针对 get_formatted_name() 的 单元 测试 。 这 个 类 可 以 随意 
命名 , 但 最 好 让 它 看 起 来 与 要 测试 的 函数 相关 并 包含 Test 字样。 这 个 类 必须 继承 unittest.TestCase 
类 ， 这 样 Python 才 知 道 如 何 运 行 你 编写 的 测试 。 


NamesTestCase 只 包含 一 个 方法 , 用 于 测试 get_formatted_name() 的 一 个 方面 。 将 该 方法 命名 
为 test_first_last_name()， 因 为 要 核实 的 是 只 有 名 和 姓 的 姓名 能 否 被 正确 格式 化 。 运 行 
test_name_function.py 时 ,所 有 以 test 打头 的 方法 都 将 自动 运行 。 在 这 个 方法 中 , 调用 了 要 测试 
的 函数 。 在 本 例 中 ,使 用 实 参 ' janis' 和 'joplin' 调 用 get_formatted_name()， 并 将 结果 赋 给 变量 
formatted name ( 见 四 )。 


在 @ 处 , 使 用 了 unittest 类 最 有 用 的 功能 之 一 : 断言 方法 。 断 言 方 法 核实 得 到 的 结果 是 否 
与 期 望 的 结果 一 致 。 在 这 里 ， 我 们 知道 get_formatted_name() 应 返回 名 和 姓 首 字母 大 写 且 之 间 有 
一 个 空格 的 姓名 ， 因 此 期 望 formatted_name 的 值 为 Janis Joplin。 为 检查 是 否 确实 如 此 ， 我们 调 
用 unittest 的 方法 assertEqual()， 并 向 它 传递 formatted _ name 和 'Janis Joplin'。 代 码 行 


self.assertEqual(formatted name, 'Janis Joplin') 


大 


地 


的 意思 是 :“ 将 formatted_name 的 值 与 字符 串 'Janis Joplin' 比较 。 如 果 它 们 相等 ， 那 么 万 
吉 ; 如 果 它 们 不 相等 ， 就 告诉 我 一 声 !” 

我 们 将 直接 运行 这 个 文件 , 但 需要 指出 的 是 , 很 多 测试 框架 都 会 先导 入 测试 文件 再 运行 。 导 
入 文件 时 , 解释 器 将 在 导入 的 同时 执行 它 。@ 处 的 if 代码 块 检查 特殊 变量 _name ,这 个 变量 是 
在 程序 执行 时 设置 的 。 如 果 这 个 文件 作为 主 程序 执行 ,变量 _name_ 将 被 设置 为 ”main '。 在 


hl 
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， 调 用 unittest.main() 来 运行 测试 用 例 。 如 果 这 个 文件 被 测试 框架 ， 变 量 _name 的 
me 是 '_main “'， 因 此 不 会 调用 unittest.main()。 


运行 test name_ function.py 时 ， 得 到 的 输出 如 下 : 


Ran 1 test in 0.000s 


OK 


第 一 行 的 句点 表明 有 一 个 测试 通过 了 。 接 下 来 的 一 行 指出 Python 运行 了 一 个 测试 ， 消 耗 的 
时 间 不 到 0.001 秒 。 最 后 的 OK 表明 该 测试 用 例 中 的 所 有 单元 测试 都 通过 了 。 

上 述 输出 表明 ， 给 定 包 含 名 和 姓 的 姓名 时 ， 函 数 get_formatted _name() 总 是 能 正确 地 处 理 。 
修改 get_ formatted name() 后 , 可 再 次 运行 这 个 测试 用 例 。 如 果 它 通过 了 , 就 表明 给 定 Janis Joplin 
这 样 的 姓名 时 ， 该 函数 依然 能 够 正确 地 处 理 。 


11.1.3 ”未 通过 的 测试 


测试 未 通过 时 结果 是 什么 样 的 呢 ? 我 们 来 修改 get_formatted_name() ,使 其 能 够 处 理 中 间 名 ， 
但 同时 故意 让 该 函数 无 法 正确 处 理 像 Janis Joplin 这 样 只 有 名 和 姓 的 姓名 。 


下 面 是 函数 get_formatted_name() 的 新 版 本 ， 它 要 求 通过 一 个 实 参 指定 中 间 名 : 


name def get formatted name(first, middle, last): 
function.py """ 生 成 整洁 的 姓名 。""" 
full name = f"{first} {middle} {last}" 
return full name.title() 


个 版 本 应 该 能 够 正确 处 理 包含 中 间 名 的 姓名 , 但 对 其 进行 测试 时 , 我 们 发 现 它 不 再 能 正确 
人 和 姓 的 姓名 。 这 次 运行 程序 test_ name _function.py 时 ， 输 出 如 下 : 


@ ERROR: test first last name ( main .NamesTestCase) 


四 Traceback (most recent Call 1ast): 
File "test name function.py", line 8, in test first last name 
formatted name = get formatted name('janis', 'joplin') 
TypeError: get formatted name() missing 1 required positional argument: "last' 


@ Ran 1 test in 0.000s 


@ FAILED (errors=1) 


function.py """ 生 成 整洁 的 姓名 
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里 面包 含 很 多 信息 ， 因 为 测试 未 通过 时 , 需要 让 你 知道 的 事情 可 能 有 很 多 。 第 一 行 输 出 只 有 
一 个 字母 EF 见 @ ), 指 出 测试 用 例 中 有 一 个 单元 测试 导致 了 错误 。 接 下 来 ,我 们 看 到 NamesTestCase 
中 的 test _first_ last_name() 导 致 了 错误 ( 见 @ )。 测试 用 例 包 含 众多 单元 测试 时 , 知道 哪个 测试 
未 通过 至 关 重 要 。 在 @ 处 ,我 们 看 到 了 一 个 标准 的 traceback， 指 出 函数 调用 get_formatted_name 
('janis'，'joplin') 有 问题 ， 因 为 缺少 一 个 必 不 可 少 的 位 置 实 参 。 

我 们 还 看 到 运行 了 一 个 单元 测试 ( 见 @ )。 最 后 是 一 条 消息 ， 指 出 整个 测试 用 例 未 通过 ， 因 
为 运行 该 测试 用 例 时 发 生 了 一 个 错误 ( 见 @ )。 这 条 消息 位 于 输出 末尾 ， 让 你 一 眼 就 能 看 到 。 你 
可 不 希望 为 获悉 有 多 少 测试 未 通过 而 翻阅 长 长 的 输出 。 


11.1.4 测试 未 通过 时 怎么 办 


测试 未 通过 时 怎么 办 呢 ? 如 果 你 检查 的 条 件 没 错 , 测试 通过 意味 着 函数 的 行为 是 对 的 ,而 测 
试 未 通过 意味 着 编写 的 新 代码 有 错 。 因 此 ,测试 未 通过 时 ， 不 要 修改 测试 ， 而 应 修复 导致 测试 不 
能 通过 的 代码 : 检查 刚刚 对 函数 所 做 的 修改 ， 找 出 导致 函数 行为 不 符合 预期 的 修改 。 


在 本 例 中 ，get_formatted_name() 以 前 只 需要 名 和 姓 两 个 实 参 ,但 现在 要 求 提供 名 、 中 间 名 
和 姓 。 新 增 的 中 间 名 参数 是 必 不 可 少 的 ， 这 导致 get_formatted name() 的 行为 不 符合 预期 。 就 这 里 
而 言 ， 最 佳 的 选择 是 让 中 间 名 变 为 可 选 的 。 这 样 做 后 ， 使 用 类 似 于 Janis Joplin 的 姓名 进行 测试 时 ， 
测试 就 又 能 通过 了 ， 而 且 也 可 以 接受 中 间 名 。 下 面 来 修改 get_formatted_name() ， 将 中 间 名 设置 为 
可 选 的， 然后 再 次 运行 这 个 测试 用 例 。 如 果 通 过 了 ， 就 接着 确认 该 函数 能 够 妥善 地 处 理 中 间 名 。 


要 将 中 间 名 设置 为 可 选 的 ， 可 在 函数 定义 中 将 形 参 middle 移 到 形 参 列表 末尾 ， 并 将 其 默认 
值 指定 为 一 个 空 字符 串 。 还 需要 添加 一 个 if 测试 ,以便 根 据 是 否 提 供 了 中 间 名 相应 地 创建 姓名 : 


name def get formatted name(first, last, middle="'): 


if middle: 
full name = f"{first} {middle} {last}" 
else: 
full name = f"{first} {last}" 
return full name.title() 


在 get formatted name() 的 这 个 新 版 本 中 ， 中 间 名 是 可 选 的 。 如 果 向 该 函数 传递 了 中 间 名 ， 
姓名 将 包含 名 、 中 间 名 和 姓 ， 否 则 姓名 将 只 包含 名 和 姓 。 现 在 ， 对 于 两 种 不 同 的 姓名 ， 这 个 函数 
都 应 该 能 够 正确 地 处 理 。 为 确定 这 个 函数 依然 能 够 正确 处 理 像 Janis Joplin 这 样 的 姓名 , 我 们 再 次 


运行 test name_fonction.py: 


Ran 1 test in 0.000s 


OK 
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现在 , 测试 用 例 通过 了 。 太 好 了 , 这 意味 着 这 个 函数 又 能 正确 处 理 像 Janis Joplin 这 样 的 姓名 
了 ， 而 且 我 们 无 须 手 工 测 试 这 个 函数 。 这 个 函数 之 所 以 很 容易 修复 ,是 因为 未 通过 的 测试 让 我 们 
得 知 新 代码 破坏 了 也 数 原来 的 行为 。 


11.1.5 ”添加 新 测试 


确定 get_formatted_name() 又 能 正确 处 理 简 单 的 姓名 后 ,我 们 再 编写 一 个 测试 ， 用 于 测试 包 
含 中 间 名 的 姓名 。 为 此 ， 在 NamesTestCase 类 中 再 添加 一 个 方法 : 


test name_ -- 5/1p-- 
function.py 
class NamesTestCase(unittest.TestCase): 
“测试 name_function.py。""" 


def test first last name(self): 


=- SNip-- 


def test first last middle name(self): 
""" 能 够 正确 地 处 理 像 Wolfgang Amadeus Mozart 这 样 的 姓名 吗 ?""" 
© formatted name = get formatted name( 
'wolfgang', 'mozart', 'amadeus') 
self.assertEqual(formatted name, 'Wolfgang Amadeus Mozart') 


if name == ' Mmain 


unittest.main() Ce 


将 该 方法 命名 为 test_first last_middle name()。 方法 名 必须 以 test 打头 ,这样 它 才 会 在 我 
们 运行 test_ name function.py 时 自动 运行 。 这 个 方法 名 清楚 地 指出 了 它 测试 的 是 get_ 
formatted name() 的 哪个 行为 。 这 样 ， 如 果 该 测试 未 通过 ， 我 们 就 能 马上 知道 受 影响 的 是 哪 种 类 型 
的 姓名 。 可 以 在 TestCase 类 中 使 用 很 长 的 方法 名 ， 而 且 这 些 方法 名 必须 是 描述 性 的 ， 这 样 你 才能 
看 懂 测 试 未 通过 时 的 输出 。 这 些 方法 由 Python 自动 调用 ， 你 根本 不 用 编写 调用 它们 的 代码 。 

为 测试 函数 get_formatted_name()， 我 们 使 用 名 、 姓 和 中 间 名 调用 它 ( 见 @ )， 再 使 用 
assertEqual() 检 查 返 回 的 姓名 是 否 与 预期 的 姓名 ( 名 、 中 间 名 和 姓 ) 一 致 。 再 次 运行 
test_name_function.py 时 ， 两 个 测试 都 通过 了 : 


Ran 2 tests in 0.000s 


OK 


太 好 了 ! 现在 我 们 知道 , 这 个 函数 又 能 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 了 , 而 且 深 信 它 
也 能 够 正确 地 处 理 像 Wolfgang Amadeus Mozart 这 样 的 姓名 。 
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动手 试 一 斌 

练习 11-1: 城市 和 国家 编写 一 个 函数 ， 它 接受 两 个 形 参 : 一 个 城市 名 和 一 个 国家 
名 。 这 个 函数 返回 一 个 格式 为 City，Couwntry 的 字符 事 ， 如 Santiago, Chile。 将 这 个 函 
数 存储 在 一 个 名 为 city functions.py 的 模块 中 。 

创建 一 个 名 为 test_cities.py 的 程序 ， 对 刚才 编写 的 函数 进行 测试 ( 别 忘 了 ， 需 要 导 
入 模块 unittest 和 要 测试 的 函数 ), 编写 一 个 名 为 test_city country() 的 方法 , 核实 使 
用 类 似 于 "santiago' 和 'chile' 这 样 的 值 来 调用 前 述 函数 时 ,得 到 的 字符 串 是 正确 的 。 运 
行 test_cities.py， 确 认 测 试 test city Country() 通 过 了 。 

练习 11-2: 人 口 数量 修改 前 面 的 函数 ， 加 上 第 三 个 必 不 可 少 的 形 参 population， 
并 返回 一 个 格式 为 City，Country - popu1ation XXX 的 字符 串 ， 如 Santiago，Chile - 
population 5000000。 运 行 test_ cities.py， 确 认 测 试 test city country() 未 通过 。 

修改 上 述 函 数 ， 将 形 参 population 设置 为 可 选 的 。 再 次 运行 test cities.py， 确 认 测 
试 test city country() 又 通过 了 。 

再 编写 一 个 名 为 test city country population() 的 测试 ， 核 实 可 以 使 用 类 似 于 
'santiago' 、'chile' 和 'population=5000000' 这 样 的 值 来 调用 这 个 函数 。 再 次 运行 
test_cities.py， 确 认 测 试 test_ city country population() 通 过 了 。 


11.2 ”测试 类 


在 本 章 前 半 部 分 ,你 编写 了 针对 单个 函数 的 测试 ， 下 面 来 编写 针对 类 的 测试 。 很 多 程序 中 都 
会 用 到 类 ,， 因 此 证 明 你 的 类 能 够 正确 工作 大 有 神 益 。 如 果 针 对 类 的 测试 通过 了 ,你 就 能 确信 对 类 
所 做 的 改进 没有 意外 地 破坏 其 原 有 的 行为 。 


11.2.1 各 种 断言 方法 


Python 在 unittest.TestCase 类 中 提供 了 很 多 断言 方法 。 前 面 说 过 ， 断 言 方法 检查 你 认为 应 
该 满足 的 条 件 是 否 确实 满足 。 如 果 该 条 件 确实 满足 ， 你 对 程序 行为 的 假设 就 得 到 了 确认 ， 可 以 确 
言 其 中 没有 错误 。 如 果 你 认为 应 该 满足 的 条 件 实际 上 并 不 满足 ，Python 将 引发 异常 。 

表 11-1 描述 了 6 个 常用 的 断言 方法 。 使 用 这 些 方法 可 核实 返回 的 值 等 于 或 不 等 于 预期 的 值 ， 
返回 的 值 为 True 或 False, 以 及 返回 的 值 在 列表 中 或 不 在 列表 中 。 只 能 在 继承 unittest. TestCase 
的 类 中 使 用 这 些 方法 ， 随 后 来 看 看 如 何在 测试 类 时 使 用 其 中 之 一 。 
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表 11-1 unittest 模块 中 的 断言 方法 


方 ” 法 用 途 
assertEqual(a, b) 核实 a == b 
assertNotEqual(a, b) 核实 a != b 
assertTrue(x) 核实 x 为 True 
assertFalse(x) 核实 x 为 False 
assertIn(item, 1ist) 核实 jtem 在 7ist 中 
assertNotIn(item, 1ist) 核实 item 不 在 1ist 中 


11.2.2 一 个 要 测试 的 类 


类 的 测试 与 函数 的 测试 相似 , 你 所 做 的 大 部 分 工作 是 测试 类 中 方法 的 行为 。 不 过 还 是 存在 一 
些 不 同 之 处 ， 下 面 编写 一 个 要 测试 的 类 。 来 看 一 个 帮助 管理 匿名 调查 的 类 : 


survey.py Class AnonymousSurvey: 
""" 收 集 匿名 调查 问卷 的 答案 。""" 


© def init (self, question): 
"" "存储 一 个 问题 ， 并 为 存储 答案 做 准备 。""" 
self.question = question 
self.responses = [] 


© def show question(self) 
mr" 显示 调查 问卷 。""" 
print(self.question) 


[3 def store response(self, new response) 
mu 存储 单 份 调查 答卷 。""" 
self.responses.append(new response) 


9 def show results(self) 
"" "显示 收集 到 的 所 有 答卷 。""" 
print("Survey results:") 
for response in self.responses: 
print(f"- {response}") 


这 个 类 首先 存储 了 一 个 调查 问题 ( 见 @ )， 并 创建 了 一 个 空 列表 ， 用 于 存储 答案 。 这 个 类 包 
含 打印 调查 问题 的 方法 ( 见 @ )， 在 答案 列表 中 添加 新 答案 的 方法 ( 见 @ )， 以 及 将 存储 在 列表 中 
的 答案 都 打印 出 来 的 方法 ( 见 @ )。 要 创建 该 类 的 实例 ， 只 需 提 供 一 个 问题 即 可 。 有 了 表示 调查 
的 实例 后 ， 就 可 使 用 show_question() 来 显示 其 中 的 问题 ， 使 用 store_response() 来 存储 答案 并 
使 用 show results() 来 显示 调查 结果 。 


为 证 明 AnonymousSurvey 类 能 够 正确 工作 ， 编 写 一 个 使 用 它 的 程序 : 
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language_ 


survey.py 


问题 创建 了 一 个 AnonymousSurvey 对 象 。 接 下 来 ， 这 个 程序 调用 show_question() 来 显示 问题 , 并 


from survey import AnonymousSurvey 


# 定义 一 个 问题 ， 并 创建 一 个 调查 。 
question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey(question) 


# 显示 问题 并 存储 答案 。 
my_survey.show question() 
print("Enter 'q' at any time to quit.\n") 


while True: 
response = input("Language: ") 
if response == 'q': 
break 


my_survey.store response(response) 


# 显示 调查 结果 。 
print("\nThank you to everyone who participated in the survey!") 
my_survey.show results() 


这 个 程序 定义 了 一 个 问题 ("What language did you first learn to speak? " )， 并 使 用 该 


提示 用 户 输入 答案 。 在 收 到 每 个 答案 的 同时 将 其 存储 起 来 。 用 户 输入 所 有 答案 (输入 q 要 求 退出 ) 
后 ， 调 用 show_results() 来 打印 调查 结 


hat language did you first learn to speak? 
Enter 'q' at any time to quit. 


Language: English 
Language: Spanish 
Language: English 
Language: Mandarin 
Language: q 


Thank you to everyone who participated in the survey! 
Survey results: 

- English 

- Spanish 

- English 

- Mandarin 


AnonymousSurvey 类 可 用 于 进行 简单 的 匿名 调查 。 假 设 我 们 将 它 放 在 了 模块 survey 中 ， 并 想 


进行 改进 : 让 每 位 用 户 都 可 输入 多 个 答案 ; 编写 一 个 方法 ， 只 列 出 不 同 的 答案 并 指出 每 个 答案 出 
现 了 多 少 次 ; 再 编写 一 个 类 ， 用 于 管理 非 匿名 调查 。 


进行 上 述 修改 存在 风险 ， 可 能 影响 AnonymousSurvey 类 的 当前 行为 。 例 如 ， 人 允许 每 位 用 户 输 


入 多 个 答案 时 , 可 能 会 不 小 心 修 改 处 理 单个 答案 的 方式 。 要 确认 在 开发 这 个 模块 时 没有 破坏 既 有 
行为 ， 可 以 编写 针对 这 个 类 的 测试 。 
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11.2.3 测试 AnonymousSurvey 类 
下 面 来 编写 一 个 测试 ， 对 AnonymousSurvey 类 的 行为 的 一 个 方面 进行 验证 : 如 果 用 户 面 对 调 


查 问题 只 提供 一 个 答案 ， 这 个 答案 也 能 被 妥善 地 存储 。 为 此 , 我 们 将 在 这 个 答案 被 存储 后 ， 使 用 
方法 assertIn() 来 核实 它 确实 在 答案 列表 中 : 


test import unittest 
surveypy from survey import AnonymousSurvey 


@ class TestAnonymousSurvey(unittest.TestCase) 
""" 针 对 AnonymousSurvey 类 的 测试 。""" 
@ def test store single response(self) 
""" 测 试 单个 答案 会 被 次 疼 地 存储 。""" 
question = "What language did you first learn to speak?" 


3 my_survey = AnonymousSurvey (question) 
my_survey.store response('English') 
@ self.assertIn('English', my_survey.responses) 
if name == ”main 


unittest.main() 


首先 导入 模块 unittest 和 要 测试 的 类 AnonymousSurvey。 将 测试 用 例 命名 为 TestAnonymousSurvey， 
它 也 继承 了 unittest.TestCase( 见 @ )。 第 一 个 测试 方法 验证 : 调查 问题 的 单个 答案 被 存储 后 ， 会 
包含 在 调查 结果 列表 中 。 对 于 这 个 方法 ， 一 个 不 错 的 描述 性 名 称 是 test_store single response() 
( 见 @ )。 如 果 这 个 测试 未 通过 ， 我们 就 能 通过 输出 中 的 方法 名 得 知 ， 在 存储 单个 调查 答案 方面 存 
在 问题 。 

要 测试 类 的 行为 ,需要 创建 其 实例 。 在 @ 处 ， 使 用 问题 "What language did you first learn 
to speak? "创建 一 个 名 为 my_survey 的 实例 , 然后 使 用 方法 store response() 存 储 单个 答案 English。 
接 下 来 ， 检查 English 是 否 包 含 在 列表 my_survey.responses 中 ， 以 核实 这 个 答案 是 否 被 妥善 地 
存储 了 ( 见 @ )。 


当 我 们 运行 test_survey.py 时 ， 测 试 通过 了 : 


Ran 1 test in 0.001s 


OK 


这 很 好 , 但 只 能 收集 一 个 答案 的 调查 用 途 不 大 。 下 面 来 核实 当 用 户 提供 三 个 答案 时 , 它们 也 
将 被 妥善 地 存储 。 为 此 ， 在 TestAnonymousSurvey 中 再 添加 一 个 方法 : 


Sy 


import unittest 
from survey import AnonymousSurvey 
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class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 


def test store single response(self): 
-- SNip-- 


def test store three responses(self): 
""" 测 试 三 个 答案 会 被 妥善 地 存储 。""" 
question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey(question) 
@ responses = ['English', 'Spanish', 'Mandarin'] 
for response in responses: 
my_survey.store response(response) 


© for response in responses: 
self.assertIn(response, my_survey.responses) 


if name == ' Mmain 
unittest.main() 


我 们 将 该 方法 命名 为 test_store three responses(), 并 像 对 test store single response() 
所 做 的 一 样 ， 在 其 中 创建 一 个 调查 对 象 。 定 义 一 个 包含 三 个 不 同 答案 的 列表 ( 见 @ )， 再 对 其 中 
每 个 答案 调用 store_response()。 存 储 这 些 答案 后 ， 使 用 一 个 循环 来 确认 每 个 答案 都 包含 在 
my_survey.responses 中 ( 见 @ )。 


再 次 运行 test_survey.py 时 ， 两 个 测试 ( 针对 单个 答案 的 测试 和 针对 三 个 答案 的 测试 ) 都 通 


Ran 2 tests in 0.000s 


OK 


前 述 做 法 的 效果 很 好 ， 但 这 些 测试 有 些 重复 的 地 方 。 下 面 使 用 unittest 的 另 一 项 功能 来 提 


ai 


11.2.4 ”方法 setUp() 


在 前 面 的 test_survey.py 中 ， 我们 在 每 个 测试 方法 中 都 创建 了 一 个 AnonymousSurvey 实例 ， 并 
在 每 个 方法 中 都 创建 了 答案 。unittest.TestCase 类 包含 的 方法 setUp() 让 我 们 只 需 创建 这 些 对 象 
一 次 ， 就 能 在 每 个 测试 方法 中 使 用 。 如 果 在 TestCase 类 中 包含 了 方法 setup() ，Python 将 先 运行 
它 , 再 运行 各 个 以 test 打头 的 方法 。 这 样 , 在 你 编写 的 每 个 测试 方法 中 , 都 可 使 用 在 方法 setUp() 
中 创建 的 对 象 。 


下 面 使 用 setup() 来 创建 一 个 调查 对 象 和 一 组 答案 ， 供 方法 test_store single response() 
和 test_store three_ responses() 使 用 : 
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import unittest 
from survey import AnonymousSurvey 


class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 


def setUp(self): 
创建 一 个 调查 对 象 和 一 组 答案 ， 供 使 用 的 测试 方法 使 用 。 


question = "What language did you first learn to speak?" 
@ self.my_survey = AnonymousSurvey(question) 
@ self.responses = ['English', 'Spanish', 'Mandarin'] 


def test store single response(self): 
"" "测试 单个 答案 会 被 要 普 地 存储 。""" 
self.my_survey.store response(self.responses[0]) 
self.assertIn(self.responses[0], self.my_ survey.responses) 


def test store three responses(self): 

"" "测试 三 个 答案 会 被 妥 普 地 存储 。""" 

for response in self.responses: 

self.my_survey.store response(response) 

for response in self.responses: 
self.assertIn(response, self.my_ survey.responses) 


if name == ' Mmain 
unittest.main() 


方法 setUp() 做 了 两 件 事情 : 创建 一 个 调查 对 象 ( 见 @ )， 以 及 创建 一 个 答案 列表 ( 见 @ )。 
存储 这 两 样 东 西 的 变量 名 包含 前 级 self ( 即 存 储 在 属性 中 )， 因 此 可 在 这 个 类 的 任何 地 方 使 用 。 
这 让 两 个 测试 方法 都 更 简单 ， 因 为 它们 都 不 用 创建 调查 对 象 和 答案 了 。 方法 test_store_single_ 
response() 核 实 self.responses 中 的 第 一 个 答案 self.responses[0] 被 妥善 地 存储 ， 而 方法 
test_store three response() 核 实 self.responses 中 的 全 部 三 个 答案 都 被 妥善 地 存储 。 


再 次 运行 test_surveypy 时 ， 这 两 个 测试 也 都 通过 了 。 如 果 要 扩展 AnonymousSurvey， 使 其 允 
许 每 位 用 户 输入 多 个 答案 ， 这 些 测 试 将 很 有 用 。 修 改 代 码 以 接受 多 个 答案 后 ， 可 运行 这 些 测试 ， 
确认 存储 单个 答案 或 一 系列 答案 的 行为 未 受 影响 。 

测试 自己 编写 的 类 时 , 方法 setup() 让 测试 方法 编写 起 来 更 容易 : 可 在 setup() 方 法 中 创建 一 
系列 实例 并 设置 其 属性 , 再 在 测试 方法 中 直接 使 用 这 些 实例 。 相 比 于 在 每 个 测试 方法 中 都 创建 实 
例 并 设置 其 属性 ， 这 要 容易 得 多 。 


注意 ”运行 测试 用 例 时 ， 每 完成 一 个 单元 测试 ，Python 都 打印 一 个 字符 : 测试 通过 时 打印 一 个 名 
点 ,测试 引发 错误 时 打印 一 个 E， 而 测试 导致 断言 失败 时 则 打印 一 个 F。 这 就 是 你 运行 测试 
用 例 时 ， 在 输出 的 第 一 行 中 看 到 的 句点 和 字符 数量 各 不 相同 的 原因 。 如 果 测 试用 例 包 含 很 
多 单元 测试 ， 需 要 运行 很 长 时 间 ， 就 可 通过 观察 这 些 结果 来 获悉 有 多 少 个 测试 通过 了 。 
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动手 试 一 试 
练习 11-3: 雇员 编写 一 个 名 为 Employee 的 类 ， 其 方法 init _() 接 受 名 、 姓 和 
年 薪 ， 并 将 它们 存储 在 属性 中 。 编 写 一 个 名 为 give raise() 的 方法 ， 它 默认 将 年 薪 增 加 


5000 美元 ， 但 也 能 够 接受 其 他 的 年 薪 增 加 量 。 

为 Employee 编写 一 个 测试 用 例 ， 其 中 包含 两 个 测试 方法 : test give default_ 
raise() 和 test give custom raise()。 使 用 方法 setUp()， 以 免 在 每 个 测试 方法 中 都 新 
建 雇员 实例 。 运 行 这 个 测试 用 例 ， 确 认 两 个 测试 都 通过 了 。 


11.3 ”小结 


在 本 章 中 ,你 学 习 了 : 如 何 使 用 模块 unittest 中 的 工具 来 为 函数 和 类 编写 测试 ; 如 何 编写 继 
承 unittest.TestCase 的 类 ， 以 及 如 何 编写 测试 方法 ， 以 核实 函数 和 类 的 行为 符合 预期 ; 如 何 使 用 
方法 setup() 来 根据 类 高 效 地 创建 实例 并 设置 其 属性 ， 以 便 在 类 的 所 有 测试 方法 中 使 用 。 


测试 是 很 多 初学 者 不 熟悉 的 主题 。 作 为 初学 者 ,并非 必 须 为 你 尝试 的 所 有 项 目 编 写 测试 。 然 
而 参与 工作 量 较 大 的 项 目 时 , 你 应 该 对 自己 所 编写 函数 和 类 的 重要 行为 进行 测试 。 这 样 你 就 能 够 
更 加 确定 自己 所 做 的 工作 不 会 破坏 项 目的 其 他 部 分 , 从 而 自由 地 改进 既 有 代码 。 如 果 不 小 心 破坏 
了 原来 的 功能 ,你 马上 就 会 知道 ,而且 能 够 轻松 地 修复 问题 。 比 起 等 到 不 满意 的 用 户 报告 bug 后 
再 采取 措施 ， 在 测试 未 通过 时 采取 措施 要 容易 得 多 。 

如 果 你 在 项 目 中 包含 了 初步 测试 , 将 得 到 其 他 程序 员 的 尊敬 。 他 们 不 仅 能 够 更 得 心 应 手 地 使 
用 你 编写 的 代码 ,也 更 愿意 与 你 合作 开发 项 目 。 如 果 要 跟 其 他 程序 员 开 发 的 项 目 共享 代码 ， 就 必 
须 证 明 你 编写 的 代码 通过 了 既 有 测试 ,通常 还 需要 为 你 添加 的 新 行为 编写 测试 。 

请 通过 多 开展 测试 来 熟悉 代码 测试 过 程 。 对 于 自己 编写 的 函数 和 类 , 请 编写 针对 其 重要 行为 
的 测试 。 不 过 不 要 在 项 目 早 期 试图 编写 全 禾 盖 的 测试 用 例 ， 除 非 有 充分 的 理由 。 


项 目 


祝贺 你 ! 你 现在 已 经 对 Python 有 足够 的 认识 ， 可 以 开始 开发 有 意思 的 交互 式 项 目 了 。 通 过 
动手 开发 项 目 ， 你 能 够 学 到 新 技能 ， 并 更 深入 理解 第 一 部 分 介绍 的 概念 。 
第 二 部 分 包含 三 个 不 同类 型 的 项 目 , 你 可 以 选择 完成 其 中 的 任意 或 全 部 项 目 , 完成 的 顺序 无 
关 紧 要 。 下 面 简要 描述 每 个 项 目 ， 帮 助 你 决定 先 去 完成 哪个 。 

外 星人 入 侵 : 使 用 Python 开发 游戏 

在 项 目 “ 外 星人 入 侵 ”( 第 12 章 ~ 第 14 章 ) 中 ,你 将 使 用 Pygame 包 来 开发 一 款 2D 游戏 。 
它 在 玩家 每 消灭 一 群 向 下 移动 的 外 星人 后 ， 将 玩家 提高 一 个 等 级 。 等 级 越 高 ， 游 戏 的 节奏 越 快 ， 
难度 越 大 。 完 成 这 个 项 目 后 ， 你 将 获得 自己 动手 使 用 Pygame 开发 2D 游戏 所 需 的 技能 。 

数据 可 视 化 

“数据 可 视 化 ”项 目 始 于 第 15 章 , 你 将 在 这 一 章 学 习 如 何 使 用 Matplotlib 和 Plotly 来 生成 数据 ， 
以 及 根据 这 些 数据 创建 实用 而 漂亮 的 图 表 。 第 16 章 介绍 如 何 从 网 上 获取 数据 ， 并 将 其 提供 给 可 
视 化 包 以 创建 天 气 图 和 世界 地 震 活动 散 点 图 。 最 后 ， 第 17 章 介绍 如 何 编写 自动 下 载 数据 并 对 其 
进行 可 视 化 的 程序 ,学 习 可 视 化 让 你 能 够 探索 数据 挖掘 领域 ,这 是 当前 在 全 球 都 非常 热门 的 技能 。 

Web 应 用 程序 

在 “Web 应 用 程序 ” 项目 ( 第 18 章 ~ 第 20 章 ) 中, 你 将 使 用 Django 包 来 创建 一 个 简单 的 Web 
应 用 程序 , 让 用 户 能 够 记录 任意 数量 的 学 习 主 题 。 用 户 将 通过 指定 用 户 名 和 密码 来 创建 账户 , 输入 
主题 ， 并 编写 条 目 来 记录 学 习 的 内 容 。 你 还 将 学 习 如 何 部 署 应 用 程序 ， 让 任何 人 都 能 够 访问 它 。 

完成 这 个 项 目 后 ， 你 将 能 够 自己 动手 创建 简单 的 Web 应 用 程序 ， 并 能 够 深入 学 习 其 他 有 关 
如 何 使 用 Django 开发 应 用 程序 的 资料 。 


项 目 1 外 星人 入 侵 


我 们 来 开发 一 个 名 为 《外 星人 入 侵 》 的 游戏 吧 ! 为 此 将 使 用 
Pygame， 这 是 一 组 功能 强大 而 有 趣 的 模块 ， 可 用 于 管理 图 形 、 动 画 
乃至 声音 ,让 你 能 够 更 轻松 地 开发 复杂 的 游戏 。 通 过 使 用 Pygame 来 
处 理 在 屏幕 上 绘制 图 像 等 任务 ， 可 将 重点 放 在 程序 的 高 级 逻辑 上 。 


在 本 章 中 ， 你 将 安装 Pygame， 再 创建 一 般 能 够 根据 用 户 输入 左 
右 移 动 和 射击 的 飞船 。 在 接 下 来 的 两 章 , 你 将 创建 一 群 作为 射 杀 目 标 
的 外 星人 ，, 并 改进 该 游戏 : 限制 可 供 玩 家 使 用 的 飞船 数 ， 并 且 添 加 记 
分 牌 。 

在 开发 这 款 游 戏 的 过 程 中 , 你 还 将 学 习 如 何 管理 包含 多 个 文件 的 项 目 。 你 将 重 构 很 多 代 
码 并 管理 文件 的 内 容 ， 以 确保 项 目 组 织 有 序 以 及 提高 效率 。 

开发 游戏 是 趣 学 语言 的 理想 方式 。 看 别人 玩 你 编写 的 游戏 能 获得 满足 感 ， 而 编写 简单 的 
游戏 有 助 于 你 明白 专业 级 游戏 是 怎么 编写 出 来 的 。 在 阅读 本 章 的 过 程 中 , 请 动手 输入 并 运行 
代码 ， 以 明和 白 各 个 代码 块 对 整个 游戏 所 做 的 贡献 ,并 且 尝 试 不同 的 值 和 设置 ， 以 对 如 何 改 进 
游戏 的 交互 性 有 更 深入 的 认识 。 


注意 游戏 《外 星人 入 侵 》 将 包含 很 多 不 同 的 文件 , 因此 请 在 系统 中 新 建 一 个 名 为 alien invasion 
的 文件 夹 ， 并 将 该 项 目的 所 有 文件 都 存储 到 该 文件 夹 中 ,这样 相关 的 import 语句 才能 正 
确 工作 。 
另外 ， 如 果 你 熟悉 版 本 控制 ， 可 能 想 将 其 用 于 这 个 项 目 ; 如 果 你 没有 使 用 过 版 本 控制 ， 
请 参阅 附录 D 的 概述 。 


12.1 规划 项 目 


开发 大 型 项 目 时 , 制定 好 规划 后 再 动手 编写 代码 很 重要 。 规 划 可 确保 你 不 偏离 轨道 ， 从 而 提 
高 项 目 成 功 的 可 能 性 。 
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下 面 来 编写 有 关 游 戏 《 外 星人 入 侵 》 的 描述 ， 其 中 虽然 没有 涵盖 这 款 游戏 的 所 有 细节 ,但 能 
让 你 清楚 地 知道 该 如 何 动 手 开发 。 


在 游戏 《外 星人 入 侵 》 中 ， 玩家 控制 一 般 最 初出 现在 屏幕 底部 中 央 的 飞船 。 玩 家 可 
以 使 用 箭头 键 左右 移动 飞船 ， 还 可 使 用 空格 键 射击 。 游 戏 开 始 时 , 一群 外 星人 出 现在 天 
空中 ,并 向 屏幕 下 方 移动 。 玩 家 的 任务 是 射 杀 这 些 外 星人 。 玩家 将 所 有 外 星人 都 消灭 干 
净 后 ， 将 出 现 一 群 新 的 外 星人 ， 其 移动 速度 更 快 。 只 要 有 外 星人 撞 到 玩家 的 飞船 或 到 达 
屏幕 底部 ， 玩 家 就 损失 一 艘 飞船 。 玩 家 损失 三 艘 飞船 后 ， 游 戏 结 束 。 


开发 的 第 一 个 阶段 将 创建 一 稻 飞 船 , 它 可 左右 移动 , 并 且 能 在 用 户 按 空格 键 时 开火 。 设 置 好 
这 种 行为 后 ， 就 可 以 创建 外 星人 并 提高 游戏 的 可 玩 性 了 。 


12.2 ”安装 Pygame 


开始 编码 前 , 先 来 安装 Pygame。 可 使 用 pip 模块 来 帮助 下 载 并 安装 Python 包 。 要 安装 Pygame， 
在 终端 提示 符 下 执行 如 下 命令 : 


$ python -m pip install --user pygame 


这 个 命令 让 Python 运行 pip 模块 ,将 pygame 包 添 加 到 当前 用 户 的 Python 安装 中 。 如 果 你 运行 
程序 或 启动 终端 会 话 时 使 用 的 命令 不 是 python， 而 是 python3 ， 请 执行 如 下 命令 来 安装 Pygame: 


$ python3 -m pip install --user pygame 


注意 ”如果 该 命令 在 macOS 系统 中 不 管用 ,请 尝试 在 不 指定 标志 --user 的 情况 下 再 次 执行 。 


12.3 ”开始 游戏 项 目 


开始 开发 游戏 《外 星人 入 侵 》 吧 。 首 先 要 创建 一 个 空 的 Pygame 窗口 ， 供 之 后 用 来 绘制 游戏 
元 素 ， 如 飞船 和 外 星人 。 我 们 还 将 让 这 个 游戏 响应 用 户 输入 ,设置 背景 色 ， 以 及 加 载 飞船 图 像 。 


12.3.1 创建 Pygame 窗口 及 响应 用 户 输入 


下 面 创建 一 个 表示 游戏 的 类 ， 以 创建 空 的 Pygame 窗口 。 为 此 ， 在 文本 编辑 器 中 新 建 一 个 文 
件 ， 将 其 保存 为 alien invasion.py， 再 在 其 中 输入 如 下 代码 : 


alien_invasion.py import sys 


import pygame 
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class AlienInvasion: 
mn 管理 游戏 资源 和 行为 的 类 """ 


def init (self): 
"" "初始化 游戏 并 创建 游戏 资源 。""" 
© pygame.init() 


© self.screen = pygame.display.set mode((1200, 800)) 
pygame.display.set caption("Alien Invasion") 


def run game(self): 
""" 开 始 游戏 的 主 循环 """ 
3 while True: 
# 监视 键盘 和 和 鼠标 事件 。 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


ge 


# 让 最 近 绘制 的 屏幕 可 见 。 
© pygame.display.flip() 


if name == ' Mmain 
# 创建 游戏 实例 并 运行 游戏 。 
ai = AlienInvasion() 
ai.run game() 


首先 ， 导 入 模块 sys 和 pygame。 模 块 pygame 包含 开发 游戏 所 需 的 功能 。 玩 家 退出 时 ， 我 们 
将 使 用 模块 sys 中 的 工具 来 退出 游戏 。 


为 开发 游戏 《外 星人 入 侵 》 我 们 创建 了 一 个 表示 它 的 类 ， 名 为 AlienInvasion。 在 这 个 类 
的 方法 _init_() 中 , 调用 函数 pygame.init() 来 初始 化 背景 设置 , 让 Pygame 能 够 正确 地 工作 
( 见 @ ), 在 @ 处 , 调用 pygame.display.set mode() 来 创建 一 个 显示 窗口 ,游戏 的 所 有 图 形 元 素 都 
将 在 其 中 绘制 。 实 参 (1200，800) 是 一 个 元 组 ， 指 定 了 游戏 窗口 的 尺寸 一 一 宽 1200 像素 、 高 800 
像素 (你 可 以 根据 自己 的 显示 器 尺寸 调整 这 些 值 )。 将 这 个 显示 窗口 赋 给 属性 self.screen， 让 这 
个 类 中 的 所 有 方法 都 能 够 使 用 它 。 

赋 给 属性 self.screen 的 对 象 是 一 个 surface。 在 Pygame 中 ，surface 是 屏幕 的 一 部 分 , 用 于 
显示 游戏 元 素 。 在 这 个 游戏 中 , 每 个 元 素 ( 如 外 星人 或 飞船 ) 都 是 一 个 surface。display. set_mode() 
返回 的 surface 表示 整个 游戏 窗口 。 激 活 游戏 的 动画 循环 后 ， 每 经 过 一 次 循环 都 将 自动 重 绘 这 个 
surface， 将 用 户 输入 触发 的 所 有 变化 都 反映 出 来 。 

这 个 游戏 由 方法 run_game() 控 制 。 该 方法 包含 一 个 不 断 运行 的 while 循环 ( 见 @ )， 而 这 个 
循环 包含 一 个 事件 循环 以 及 管理 屏幕 更 新 的 代码 。 事件 是 用 户 玩 游戏 时 执行 的 操作 ， 如 按键 或 移 
动 鼠标 。 为 程序 响应 事件 ， 可 编写 一 个 事件 循环 ， 以 侦 听 事件 并 根据 发 生 的 事件 类 型 执行 合适 的 
任务 。@ 处 的 for 循环 就 是 一 个 事件 循环 。 
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为 访问 Pygame 检测 到 的 事件 ， 我 们 使 用 了 男 数 pygame.event.get()。 这 个 函数 返回 一 个 列 
表 ,， 其 中 包含 它 在 上 一 次 被 调用 后 发 生 的 所 有 事件 。 所 有 键盘 和 鼠标 事件 都 将 导致 这 个 for 循环 
运行 。 在 这 个 循环 中 ， 我 们 将 编写 一 系列 if 语句 来 检测 并 响应 特定 的 事件 。 例 如 ， 当 玩家 单 击 
游戏 窗口 的 关闭 按钮 时 ， 将 检测 到 pygame.QUIT 事件 ， 进 而 调用 sys.exit() 来 退出 游戏 ( 见 @ )。 

@ 处 调用 了 pygame.display.flip()， 命 令 Pygame 让 最 近 绘 制 的 屏幕 可 见 。 在 这 里 ， 它 在 每 
次 执行 while 循环 时 都 绘制 一 个 空 屏 幕 ， 并 擦 去 旧 屏 幕 ,， 使 得 只 有 新 屏幕 可 见 。 我 们 移动 游戏 元 
素 时 ，pygame.display.flip() 将 不 断 更 新 屏幕 ， 以 显示 元 素 的 新 位 置 , 并 且 在 原来 的 位 置 隐藏 元 
素 ， 从 而 营造 平滑 移动 的 效果 。 

在 这 个 文件 末尾 ,创建 一 个 游戏 实例 并 调用 run_game()。 这 些 代码 放 在 一 个 if 代码 块 中 ， 
仅 当 直接 运行 该 文件 时 , 它们 才 会 执行 。 如果 此 时 运行 alien_invasion.py, 将 看 到 一 个 空 的 Pygame 
窗口 。 


12.3.2 ”设置 背景 


Pygame 默认 创建 一 个 黑色 屏幕 ， 这 太 乏 味 了 。 下 面 来 将 背景 设置 为 另 一 种 颜色 ， 这 是 在 方 
法 _init () 末 尾 进 行 的 : 


alien_invasion.py def init (self): 
-- SNip-- 
pygame.display.set caption("Alien Invasion") 


# 设置 背景 色 。 
@ self.bg color = (230，230，230) 


def run game(self): 
-- SNip-- 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


# 每 次 循环 时 都 重 绘 屏幕 。 
@ self.screen.fill(self.bg color) 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


在 Pygame 中 ， 颜 色 是 以 RGB 值 指定 的 。 这 种 颜色 由 红色 、 绿 色 和 蓝 色 值 组 成 ， 其 中 每 个 
值 的 可 能 取 值 范围 都 是 0 ~ 255。 颜 色 值 255, 0, 0) 表 示 红 色 ，(0, 255, 0) 表 示 绿 色 ， 而 (0, 0, 255) 表 
示 蓝 色 。 通 过 组 合 不 同 的 RGB 值 ， 可 创建 1600 万 种 颜色 。 在 颜色 值 (230, 230,230) 中 , 红色 、 绿 
色 和 蓝 色 的 量 相 同 ， 它 生成 一 种 浅 灰色 。 我 们 将 这 种 颜色 赋 给 了 self.bg_color ( 见 @ )。 


在 @ 处 ， 调 用 方法 fill() 用 这 种 背景 色 填 充 屏幕 。 方 法 fill() 用 于 处 理 surface， 只 接受 一 
个 实 参 : 一 种 颜色 。 
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12.3.3 创建 设置 类 


每 次 给 游戏 添加 新 功能 时 ， 通 常 也 将 引入 一 些 新 设置 。 下 面 来 编写 一 个 名 为 settings 的 模 
块 ， 在 其 中 包含 一 个 名 为 Settings 的 类 ， 用 于 将 所 有 设置 都 存储 在 一 个 地 方 ， 以 免 在 代码 中 到 
处 添加 设置 。 这 样 ， 每 当 需 要 访问 设置 时 ， 只 需 使 用 一 个 设置 对 象 。 另 外 ,在 项 目 增 大 时 ， 这 使 
得 修改 游戏 的 外 观 和 行为 更 容易 : 要 修改 游戏 ， 只 需 修改 ( 接 下 来 将 创建 的 ) settings.py 中 的 一 
些 值 ， 而 无 须 查 找 散 布 在 项 目 中 的 各 种 设置 。 


在 文件 夹 alien invasion 中 ， 新 建 一 个 名 为 settings.py 的 文件 ， 并 在 其 中 添加 如 下 Settings 


类 : 


settings.py Class Settings: 


"" "存储 游戏 《外 星人 入 侵 》 中 所 有 设置 的 类 """ 


def init (self): 
"" "初始 化 游戏 的 设置 。""" 
# 屏幕 设置 
self.screen width = 1200 
self.screen height = 800 
self.bg color = (230，230，230) 


为 在 项 目 中 创建 settings 实例 并 用 它 来 访问 设置 ， 需 要 将 alien_invasion.py 修改 成 下 面 这 样 : 


alien_invasion.py -- Ss/ip-- 


import pygame 


from settings import Settings 


class AlienInvasion: 
"" "管理 游 戏 资源 和 行为 的 类 """ 


def init (self): 
"" "初始化 游戏 并 创建 游戏 资源 
pygame.init() 
© self.settings = Settings() 


© self.screen = pygame.display.set mode( 
(self.settings.screen width, self.settings.screen height)) 
pygame.display.set caption("Alien Invasion") 


def run game(self): 
-- SNip-- 
# 每 次 循环 时 都 重 绘 屏幕 
@ self.screen.fill(self.settings.bg color) 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 
-- Snip-- 
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在 主 程序 文件 中 ,导入 Settings 类 ,调用 pygame.init()， 再 创建 一 个 Settings 实例 并 将 其 
赋 给 self.settings( 见 @ )。 创 建 屏 幕 时 ( 见 @ )， 使 用 了 self.settings 的 属性 screen_width 
和 screen_height。 接 下 来 填充 屏幕 时 ， 也 使 用 了 self.settings 来 访问 背景 色 ( 见 @ )。 


如 果 此 时 运行 alien invasion.py， 结 果 不 会 有 任何 不 同 ， 因 为 我 们 只 是 将 设置 移 到 了 不 同 的 
地 方 。 现 在 可 以 在 屏幕 上 添加 新 元 素 了 。 


12.4 添加 飞船 图 像 


下 面 将 飞船 加 入 游戏 中 。 为 了 在 屏幕 上 绘制 玩家 的 飞船 , 我 们 将 加 载 一 幅 图 像 , 再 使 用 Pygame 
方法 blit() 绘 制 它 。 


为 游戏 选择 素材 时 ， 务 必要 注意 许可 。 最 安全 、 最 不 费 钱 的 方式 是 使 用 Pixabay 等 网 站 提供 
的 免费 图 形 ， 无 须 授权 许可 即 可 使 用 并 修改 。 


在 游戏 中 几乎 可 以 使 用 任何 类 型 的 图 像 文件 ,但 使 用 位 图 ( .bmp ) 文 件 最 为 简单 ,因为 Pygame 
默认 加 载 位 图 。 虽 然 可 配置 Pygame 以 使 用 其 他 文件 类 型 但 有 些 文件 类 型 要 求 你 在 计算 机 上 安 
装 相 应 的 图 像 库 。 大 多 数 图 像 为 jpg、.png 或 .gf 格式 ,但 可 使 用 Photoshop 、GIMP 和 Paint 等 工 
具 将 其 转换 为 位 图 。 


选择 图 像 时 , 要 特别 注意 背景 色 。 请 尽 可 能 选择 背景 为 透明 或 纯色 的 图 像 , 便于 使 用 图 像 编 
辑 器 将 其 背景 蔡 换 为 任意 颜色 。 图 像 的 背景 色 与 游戏 的 背景 色 匹 配 时 , 游戏 看 起 来 最 漂亮 。 你 也 
可 以 将 游戏 的 背景 色 设置 成 图 像 的 背景 色 。 

就 游戏 《外 星人 入 侵 》 而 言 ， 可 使 用 文件 ship.bmp (如 图 12-1 所 示 )， 该 文件 可 在 本 书 源 代 
码 文件 中 找到 ( chapter 12/adding_ ship image/images/ship.bmp )。 这 个 文件 的 背景 色 与 项 目 使 用 的 
设置 相同 。 请 在 项 目 文件 夹 ( alien invasion ) 中 新 建 一 个 名 为 images 的 文件 夹 , 并 将 文件 ship.bmp 
保存 在 其 中 。 


图 12-1 游戏 《外 星人 入侵》 中 的 飞船 
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12.4.1 创建 Ship 类 


选择 用 于 表示 飞船 的 图 像 后 ， 需 要 将 其 显示 到 屏幕 上 。 我 们 创建 一 个 名 为 ship 的 模块 ， 其 
中 包含 ship 类 ， 负 责 管理 飞船 的 大 部 分 行为 。 


ship.py import pygame 


class Ship: 
mm 管理 飞船 的 类 """ 


def _init (self, ai game): 
"" "初始 化 飞船 并 设置 其 初始 位 置 。""" 
© self.screen = ai game.screen 
© self.screen rect = ai game.screen.get rect() 


# 加 载 飞船 图 像 并 获取 其 外 接 矩 形 。 
3 self.image = pygame.image.1load('images/ship.bmp') 
self.rect = self.image.get rect() 


# 对 于 每 稻 新 飞船 ， 孝 将 其 放 在 屏幕 底部 的 中 央 。 


@ self.rect.midbottom = self.screen Tect.midbottom 


5 def blitme(self): 
""" 在 指定 位 置 绘 制 飞船 。""" 
self.screen.blit(self.image, self.rect) 


Pygame 之 所 以 高 效 , 是 因为 它 让 你 能 够 像 处 理 和 矩形 ( rect 对 象 ) 一 样 处 理 所 有 的 游戏 元 素 ， 
即便 其 形状 并 非 矩 形 。 像 处 理 和 矩形 一 样 处 理 游戏 元 素 之 所 以 高 效 , 是 因为 矩形 是 简单 的 几何 形状 。 
例如 ， 通 过 将 游戏 元 素 视 为 矩形 ，Pygame 能 够 更 快 地 判断 出 它们 是 否 发 生 了 碰撞 。 这 种 做 法 的 
效果 通常 很 好 ,游戏 玩家 几乎 注意 不 到 我 们 处 理 的 并 不 是 游戏 元 素 的 实际 形状 。 在 这 个 类 中 , 我 
们 将 把 飞船 和 屏幕 作为 矩形 进行 处 理 。 

定义 这 个 类 之 前 ， 导 入 了 模块 pygame。Ship 的 方法 ”init () 接 受 两 个 参数 : 引用 self 和 
指向 当前 AlienInvasion 实例 的 引用 。 这 让 Ship 能 够 访问 AlienInvasion 中 定义 的 所 有 游戏 资源 。 
在 @ 人 处 ,将 屏幕 赋 给 了 Ship 的 一 个 属性 ， 以 便 在 这 个 类 的 所 有 方法 中 轻松 访问 。 在 @ 处 ， 使 用 
方法 get_rect() 访 问 屏幕 的 属性 rect, 并 将 其 赋 给 了 self.screen_ rect,， 这 让 我 们 能 够 将 飞船 放 
到 屏幕 的 正确 位 置 。 

调用 pygame.image.10ad() 加 载 图 像 ， 并 将 飞船 图 像 的 位 置 传递 给 它 ( 见 @ )。 该 函数 返回 一 
个 表示 飞船 的 surface ， 而 我 们 将 这 个 surface 赋 给 了 self.image。 加 载 图 像 后 ， 使 用 get rect() 
获取 相应 surface 的 属性 rect， 以 便 后 面 能 够 使 用 它 来 指定 飞船 的 位 置 。 

处 理 rect 对 象 时 ， 可 使 用 矩形 四 角 和 中 心 的 x 坐标 和 y 坐标。 可 通过 设置 这 些 值 来 指定 矩 
形 的 位 置 。 要 让 游戏 元 素 居中 ， 可 设置 相应 rect 对 象 的 属性 center、centerx 或 centery; 要 让 
游戏 元 素 与 屏幕 边缘 对 齐 ， 可 使 用 属性 top、bottom、left 或 right。 除 此 之 外 ， 还 有 一 些 组 合 
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属性 ， 如 midbottom 、midtop 、midleft 和 midright。 要 调整 游戏 元 素 的 水 平 或 垂直 位 置 ， 可 使 用 
属性 x 和 y， 分 别 是 相应 矩形 左上 角 的 x 坐标 和 yy 坐标。 这 些 属性 让 你 无 须 做 游戏 开发 人 员 原 本 
需要 手工 完成 的 计算 ， 因 此 会 经 常用 到 。 


注意 在 Pygame 中 ,原点 (0,0) 位 于 屏幕 左上 角 , 向 右 下 方 移动 时 , 坐标 值 将 增 大 。 在 1200 x 800 
的 屏幕 上 , 原点 位 于 左上 角 , 而 右 下 角 的 坐标 为 (1200,800)。 这 些 坐 标 对 应 的 是 游戏 窗口 ， 
而 不 是 物理 屏幕 。 


我 们 要 将 飞船 放 在 屏幕 底部 的 中 央 。 为 此 ， 将 self.rect.midbottom 设置 为 表示 屏幕 的 矩形 
的 属性 midbottom ( 见 @ )。Pygame 使 用 这 些 rect 属性 来 放置 飞船 图 像 ， 使 其 与 屏幕 下 边缘 对 齐 
并 水 平 居 中 。 


在 @ 处 ,定义 了 方法 blitme()， 它 将 图 像 绘制 到 self.rect 指定 的 位 置 。 


12.4.2 ”在 屏幕 上 绘制 飞船 
下 面 更 新 alien_invasion.py， 创 建 一 稻 飞 船 并 调用 其 方法 blitme(): 


alien_invasion.py  -- S11p-- 
from settings import Settings 
from ship import Ship 


class AlienInvasion: 
mn 管理 游戏 资源 和 行为 的 类 """ 


def init (self): 
-- Snip-- 
pygame.display.set caption("Alien Invasion") 


© self.ship = Ship(self) 


def run game(self): 
-- SNnip-- 
# 每 次 循环 时 部 重 绘 屏幕 
self.screen.fill(self.settings.bg color) 
@ self.ship.blitme() 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 
--Snip-- 


导入 ship 类 ， 并 在 创建 屏幕 后 创建 一 个 Ship 实例 ( 见 @ )。 调 用 ship() 时 ， 必须 提供 一 个 
人 参数: 一 个 AlienInvasion 实例 。 在 这 里 ，self 指向 的 是 当前 AlienInvasion 实例 。 这 个 参数 让 
Ship 能 够 访问 游戏 资源 ， 如 对 象 screen。 我 们 将 这 个 Ship 实例 赋 给 了 self.ship。 


填充 背景 后 ， 调 用 ship.blitme() 将 飞船 绘制 到 屏幕 上 ， 确 保 它 出 现在 背景 前 面 ( 见 @ )。 
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现在 如 果 运 行 alien_invasion.py， 将 看 到 飞船 位 于 空 游戏 屏幕 底部 的 中 央 ， 如 图 12-2 所 示 。 


Alien Invasion 


会 


图 12-2 ”游戏 《外 星人 入侵 》 屏 幕 底部 的 中 央 有 一 稻 飞 船 


12.5 重 构 : 方法 check events() 和 _ update screen() 


在 大 型 项 目 中 ,经 常 需要 在 添加 新 代码 前 重 构 既 有 代码 。 重 构 旨 在 简化 既 有 代码 的 结构 , 使 
其 更 容易 扩展 。 本 节 将 把 越 来 越 长 的 方法 run_game() 拆 分 成 两 个 辅助 方法 (helper method )。 辅 
助 方法 在 类 中 执行 任务 ， 但 并 非 是 通过 实例 调用 的 。 在 Python 中 ， 辅 助 方 法 的 名 称 以 单个 下 划 
线 打头 。 


12.5.1 方法 _check events() 


我 们 将 把 管理 事件 的 代码 移 到 一 个 名 为 _check_events() 的 方法 中 ,以 简化 run_game() 并 隔离 
事件 管理 循环 。 通 过 隔离 事件 循环 ， 可 将 事件 管理 与 游戏 的 其 他 方面 ( 如 更 新 屏幕 ) 分 离 。 


下 面 是 新 增 方法 _check_events() 后 的 AlienInvasion 类 ， 只 有 run_game() 的 代码 受到 影响 : 


alien_invasion.py def run game(self) > 
"" "开始 游 戏 主 循环 。""" 
while True: 
© self. check events() 
# 每 次 循环 时 都 重 绘 屏幕 
--Snip-- 


© def check events(self): 
""" 响 应 按键 和 和 饼 标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


新 增 方法 _check_events()( 见 @ )， 并 将 检查 玩家 是 否 单 击 了 关闭 窗口 按钮 的 代码 移 到 该 方 
法 中 。 

要 调用 当前 类 的 方法 ,可 使 用 句点 表示 法 ， 并 指定 变量 名 self 和 要 调用 的 方法 的 名 称 ( 见 @ )。 
我 们 在 run_game() 的 while 循环 中 调用 这 个 新 增 的 方法 。 


12.5.2 方法 _update_screen() 
为 进一步 简化 run_game() ， 将 更 新 屏幕 的 代码 移 到 一 个 名 为 _ update_screen() 的 方法 中 : 


alien_invasion.py def run game(self): 
""" 开 始 游戏 主 循环 。""" 
while True: 
self. check events() 
self. update screen() 


def check events(self): 
== Snip-- 


def update screen(self): 
“更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 。 ”” 
self.screen.fill(self.settings.bg color) 
self.ship.blitme() 


pygame.display.flip() 


我 们 将 绘制 背景 和 飞船 以 及 切换 屏幕 的 代码 移 到 了 方法 _update_screen() 中 。 现 在 ，run_game() 
中 的 主 循环 简单 多 了 ， 很 容易 看 出 在 每 次 循环 中 都 检测 了 新 发 生 的 事件 并 更 新 了 屏幕 。 

如 果 你 开发 过 大 量 的 游戏 , 可 能 早 就 开始 像 这 样 将 代码 放 到 不 同 的 方法 中 了 。 不 过 如 果 你 从 
未 开发 过 这 样 的 项 目 ， 可 能 不 知道 如 何 组 织 代码 。 这 里 采用 的 做 法 是 ， 先 编写 可 行 的 代码 ， 等 代 
码 越 来 越 复 杂 时 再 进行 重 构 ， 以 向 你 展示 真正 的 开发 过 程 : 先 编写 尽 可 能 简单 的 代码 ,等 项 目 越 
来 越 复 杂 后 对 其 进行 重 构 。 


对 代码 进行 重 构 使 其 更 容易 扩展 后 ， 可 以 开始 处 理 游戏 的 动态 方面 了 ! 
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动手 试 一 斌 


练习 12-1: 蓝 色 天 空 创建 一 个 背景 为 蓝 色 的 Pygame 窗口 。 


练习 12-2: 游戏 角色 ” 找 一 幅 你 喜欢 的 游戏 角色 位 图 图 像 或 将 一 幅 图 像 转换 为 位 图 。 
创建 一 个 类 ， 将 该 角色 绘制 到 屏幕 中 央 ， 并 将 该 图 像 的 背景 色 设置 为 屏幕 背景 色 ， 或 者 
将 屏幕 背景 色 设 置 为 该 图 像 的 背景 色 。 


12.6 ”驾驶 飞船 

下 面 来 让 玩家 能 够 左右 移动 飞船 。 我 们 将 编写 代码 ， 在 用 户 按 左 或 右 箭 头 键 时 做 出 响应 。 我 
们 将 首先 专注 于 向 右 移动 ， 再 使 用 同样 的 原理 来 控制 向 左 移动 。 通 过 这 样 做 ， 你 将 学 会 如 何 控制 
屏幕 图 像 的 移动 。 


12.6.1 响应 按键 

每 当 用 户 按键 时 ， 都 将 在 Pygame 中 注册 一 个 事件 。 事 件 都 是 通过 方法 pygame.event.get() 
获取 的 , 因此 需要 在 方法 _check_events() 中 指定 要 检查 哪些 类 型 的 事件 。 每 次 按键 都 被 注册 为 一 
个 KEYDOWN 事件 。 

Pygame 检测 到 KEYDOWN 事件 时 ， 需 要 检查 按 下 的 是 否 是 触发 行动 的 键 。 例 如 ， 如 果 玩 家 按 
下 的 是 右 箭头 键 ， 就 增 大 飞船 的 rect.centerx 值 ， 将 飞船 向 右 移动 : 


alien_invasion.py def check events(self) : 
""" 响 应 按键 和 和 鼠标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


@ elif event.type == pygame.KEYDOWN: 

© if event.key == pygame.K_RIGHT: 
# 向 右 移动 飞船 。 

@ self.ship.rect.x += 1 


在 方法 _check_events() 中 ,为 事件 循环 添加 一 个 elif 代码 块 , 以 便 在 Pygame 检测 到 KEYDOWN 
事件 时 做 出 响应 ( 见 @ )。 我 们 检查 按 下 键 ( event.key ) 是 否 是 右 箭头 键 (pygame.K_RIGHT ) ( 见 
@ )。 如 果 是 ， 就 将 self.ship.rect.centerx 的 值 加 1， 从 而 将 飞船 向 右 移动 ( 见 @ )。 


如 果 现 在 运行 alien_invasion.py， 则 每 按 右 箭头 键 一 次 ， 飞 船 都 将 向 右 移动 1 像素 。 这 是 一 
个 开端 ， 但 并 非 控制 飞船 的 高 效 方式 。 下 面 来 改进 控制 方式 ， 人 允许 持续 移动 。 
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12.6.2 ”允许 持续 移动 

玩家 按 住 右 箭 头 键 不 放 时 ,我 们 希望 飞船 不 断 向 右 移 动 , 直到 玩家 松 开 为 止 。 我 们 将 让 游戏 
检测 pygame.KEYUP 事件 ， 以 便 知 道 玩家 何 时 松 开 右 箭头 键 。 然 后 ， 结 合 使 用 KEYDOWN 和 KEYUP 事 
件 以 及 一 个 名 为 moving_ right 的 标志 来 实现 持续 移动 。 

当 标 志 moving_right 为 False 时 ， 飞 船 不 会 移动 。 玩 家 按 下 右 箭 头 键 时 , 我们 将 该 标志 设置 
为 True， 在 玩家 松 开 时 将 该 标志 重新 设置 为 False。 

飞船 的 属性 都 由 Ship 类 控制 ， 因 此 要 给 这 个 类 添加 一 个 名 为 moving_right 的 属性 和 一 个 名 
为 update() 的 方法 。 方 法 update() 检 查 标志 moving right 的 状态 。 如 果 该 标志 为 True， 就 调整 
飞船 的 位 置 。 我 们 将 在 while 循环 中 调用 这 个 方法 ， 以 调整 飞船 的 位 置 。 

下 面 是 对 Ship 类 所 做 的 修改 : 


ship.py class Ship: 
mn 管理 飞船 的 类 """ 


def init (self, ai game): 
-- Snip-- 
# 对 于 每 稻 新 飞船 ， 部 将 其 放 在 屏幕 底部 的 中 央 。 
self.rect.midbottom = self.screen rect.midbottom 


# 移动 标志 。 
@ self.moving right = False 


2 def update(self) : 
"根据 移动 标志 调整 飞船 的 位 置 。 ”” 
if self.moving right: 
self.rect.x += 1 


def blitme(self): 
--Snip-- 


在 方法 _init () 中 , 添加 属性 self.moving right， 并 将 其 初始 值 设置 为 False ( 见 @ )。 接 
下 来 , 添加 方法 update() , 在 前 述 标志 为 True 时 向 右 移 动 飞船 ( 见 @ ), 方 法 update() 将 通过 Ship 
实例 来 调用 ， 因 此 不 是 辅助 方法 。 

接 下 来 ,需要 修改 _ check_events() ,使 其 在 玩家 按 下 右 箭头 键 时 将 moving_ right 设置 为 True， 
并 在 玩家 松 开 时 将 moving_ right 设置 为 False: 


alien_invasion.py def check events(self): 
“”“ 响 应 按键 和 鼠标 事件 。 ”” 
for event in pygame.event.get(): 
-- Snip-- 
elif event.type == pygame.KEYDOWN: 
if event.key == pygame.K_ RIGHT: 
@ self.ship.moving Tight = True 
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© elif event.type == pygame.KEYUP: 
if event.key == pygame.K_RIGHT: 
self.ship.moving right = False 


在 @ 人 处 ， 修 改 游戏 在 玩家 按 下 右 箭头 键 时 响应 的 方式 : 不 直接 调整 飞船 的 位 置 ， 而 只 是 将 
moving Tight 设置 为 True。 在 @ 处 ,添加 一 个 新 的 elif 代码 块 ， 用 于 响应 KEYUP 事件 : 玩家 松 
开 右 箭头 键 (K_RIGHT ) 时 , 将 moving right 设置 为 False。 


最 后 , 需要 修改 run_game() 中 的 while 循环 ， 以 便 每 次 执行 循环 时 都 调用 飞船 的 方法 update(): 


alien_invasion.py def run game(self): 
"" "开始 游 戏 主 循环 。""" 
while True: 
self. check events() 
self. ship.update() 
self. update screen() 


飞船 的 位 置 将 在 检测 到 键盘 事件 后 〈 但 在 更 新 屏幕 前 ) 更 新 。 这 样 ， 玩 家 输入 时 ， 飞 船 的 位 
置 将 更 新 ， 从 而 确保 使 用 更 新 后 的 位 置 将 飞船 绘制 到 屏幕 上 。 


如 果 现 在 运行 alien_invasion.py 并 按 住 右 箭头 键 ， 飞 船 将 持续 向 右 移动 ， 直 到 松 开 为 止 。 
12.6.3 左右 移动 


现在 飞船 能 够 持续 癌 右 移动 了 ， 添 加 问 左 移动 的 逻辑 也 很 容易 。 我 们 将 再 次 修改 Ship 类 和 方 
法 _check_events()。 下 面 显 示 了 对 Ship 类 的 方法 _init _() 和 update() 所 做 的 相关 修改 : 


ship.py def init (self, ai game): 
-- Snip-- 
# 移动 标志 
self.moving right = False 
self.moving left = False 


def update(self) : 
""” "根据 移动 标志 调整 飞船 的 位 置 。””” 

if self.moving right: 
self.rect.x += 

if self.moving left: 
self.rect.x -= 


在 方法 _init () 中 , 添加 标志 self.moving left。 在 方法 update() 中 , 添加 一 个 if 代码 块 
而 不 是 elif 代码 块 ， 这 样 如 果 玩 家 同时 按 下 了 左右 箭头 键 ， 将 先 增加 再 减少 飞船 的 rect.x 值 ， 
即 飞船 的 位 置 保持 不 变 。 如 果 使 用 一 个 elif 代码 块 来 处 理 向 左 移动 的 情况 ， 右 箭头 键 将 始终 处 
于 优先 地 位 。 从 向 左 移动 切换 到 向 右 移 动 时 ,玩家 可 能 同时 按 住 左右 箭头 键 , 此 时 前 面 的 做 法 让 
移动 更 准确 。 
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还 需 对 _check_events() 做 两 方面 的 调整 : 


alien_invasion.py def check events(self): 
“”“ 响 应 按键 和 鼠标 事件 。 ”” 
for event in pygame.event.get(): 
=-517D-- 
elif event.type == pygame.KEYDOWN: 
if event.key == pygame.K_ RIGHT: 
self.ship.moving right = True 
elif event.key == pygame.K_LEFT: 
self.ship.moving left = True 


elif event.type == pygame.KEYUP: 
if event.key == pygame.K_ RIGHT: 
self.ship.moving right = False 
elif event.key == pygame.K_LEFT: 
self.ship.moving left = False 


如 果 


因 玩家 按 下 K_LEFT 键 而 触发 了 KEYDOWN 事件 , 就 将 moving left 设置 为 True。 如 果 因 玩 
_LEFT 而 触发 了 KEYUP 事件 ， 就 将 moving left 设置 为 False。 这 里 之 所 以 可 以 使 用 elif 


代码 块 , 是 因为 每 个 事件 都 只 与 一 个 键 相关 联 。 如 果 玩 家 同时 按 下 左右 箭头 键 , 将 检测 到 两 个 不 


家 松 开 K 
同 的 事件 。 

如 果 此 时 运行 alien invasion.py， 将 能 够 持续 左 
船 将 纹 丝 不 动 。 

下 面 来 进一步 优化 飞船 的 移动 方式 : 调整 飞船 
失 在 屏幕 之 外 。 
12.6.4 ”调整 飞船 的 速度 


当前 ， 每 次 执行 while 循环 时 ， 飞 船 最 多 移动 1 像素 , 但 可 在 Settings 类 中 添加 


ship_speed， 用 于 控制 飞船 的 速度 。 我 们 将 根据 这 个 
下 面 演 示 了 如 何在 settings.py 中 添加 这 个 新 属 4 


上 E 


wd 


右 移动 飞船 。 如 果 同 时 按 下 左右 箭头 键 ， 飞 


的 速度 ,以 及 限制 飞船 的 移动 距离 ,以免 其 消 


| 
PT 


轩 性 决定 飞船 在 每 次 循环 时 最 多 移动 多 远 。 


settings.py Class Settings: 
""" 存 储 游戏 《外 星人 入 侵 》 中 所 有 设置 的 类 
def init (self): 
-- Snip-- 


# 飞船 设置 
self.ship speed = 1.5 


将 ship_speed 的 初始 值 设置 为 1.5。 现 在 需要 移动 飞船 时 ， 每 次 循环 将 移动 1.5 像素 而 不 是 1 


像素 。 
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通过 将 速度 设置 指定 为 小 数值 ， 可 在 后 面 加 快 游戏 节奏 


更 细致 地 控制 飞船 的 速度 。 然 而 ， 


rect 的 x 等 属性 只 能 存储 整数 值 ， 因 此 需要 对 Ship 类 做 些 修改 : 


shippy class Ship: 
"管理 飞船 的 类 """ 


© def init (self, ai game): 
"" "初始 化 飞船 并 设置 其 初始 位 置 。""" 
self.screen = ai game.screen 
self.settings = ai game.settings 
-- Snip-- 


# 对 于 每 稻 新 飞船 ， 都 将 其 放 在 屏幕 底部 的 中 央 
-- Snip-- 


# 在 飞船 的 属性 X 中 存储 小 数值 。 
© self.x = float(self.rect.x) 


# 移动 标志 
self.moving right = False 
self.moving left = False 


def update(self) : 
“”" 根 据 移 动 标志 调整 飞船 的 位 置 。 ”” 
# 更 新 飞船 而 不 是 Tect 对 象 的 X 值 。 
if self.moving right: 
3 self.x += self.settings.ship speed 
if self.moving left: 
self.x -= self.settings.ship speed 


# 根据 sSelf.x 更 新 rect 对 象 。 
@ self.rect.x = self.x 


def blitme(self): 
--SNnip-- 


在 @ 处 ,给 Ship 类 添加 属性 settings， 以 便 能 够 在 update() 中 使 用 它 。 鉴 于 现在 调整 飞船 
的 位 置 时 ， 将 增 减 一 个 单位 为 像素 的 小 数值 ， 因 此 需要 将 位 置 赋 给 一 个 能 够 存储 小 数值 的 变量 。 
可 使 用 小 数 来 设置 rect 的 属性 ,但 rect 将 只 存储 这 个 值 的 整数 部 分 。 为 准确 存储 飞船 的 位 置 ， 


定义 一 个 可 存储 小 数值 的 新 属性 self.x ( 见 @ ), 使 用 函数 人 
数 ， 并 将 结果 赋 给 self.x。 


Loat () 将 self.rect.x 的 值 转换 为 小 


现在 在 update() 中 调整 飞船 的 位 置 时 ,将 self.x 的 值 增 减 settings.ship_speed 的 值 ( 见 @ )。 
更 新 self.x 后 , 再 根据 它 来 更 新 控制 飞船 位 置 的 self.rect.x( 见 @ ), self.rect.x 只 存储 self.x 


的 整数 部 分 ， 但 对 显示 飞船 而 言 ， 这 问题 不 大 。 


现在 可 以 修改 ship_speed 的 值 了 。 只 要 它 的 值 大 于 1， 飞船 的 移动 速度 就 会 比 以 前 更 快 。 这 有 
助 于 让 飞船 的 反应 速度 足够 快 ， 以 便 射 杀 外 星人 ， 还 让 我 们 能 够 随 着 游戏 的 进行 加 快 游戏 的 节奏 。 


注意 ”如果 你 使 用 的 是 macOS, 可 能 发 现 即 便 ship speed 的 值 很 大 , 飞船 的 移动 速度 还 是 很 慢 。 
要 修复 这 种 问题 ， 可 在 全 屏 模 式 下 运行 游戏 ， 我 们 稍 后 就 将 实现 这 种 功能 。 
12.6.5 ”限制 飞船 的 活动 范围 


当前 ,如果 玩 家 按 住 箭头 键 的 时 间 足 够 长 ， 飞 船 将 飞 到 屏幕 之 外 ,消失 得 无 影 无 踪 。 下 面 来 
修复 这 种 问题 ， 让 飞船 到 达 屏 幕 边缘 后 停止 移动 。 为 此 ， 将 修改 Ship 类 的 方法 update(): 


ship.py def update(self): 
"" "根据 移 动 标志 调整 飞船 的 位 置 
# 更 新 飞船 而 不 是 Tect 对 象 的 X 值 。 


© if self.moving right and self.rect.right «< self.screen rect.right: 
self.x += self.settings.ship speed 
© if self.moving left and self.rect.left > 0: 


self.x -= self.settings.ship speed 


# 根据 self.x 更 新 Iect 对 象 。 
self.rect.x = self.x 


上 述 代 码 在 修改 self.x 的 值 之 前 检查 飞船 的 位 置 。self.rect.right 返回 飞船 外 接 和 矩形 右 
边缘 的 x 坐标 。 如 果 这 个 值 小 于 self.screen rect.right 的 值 ， 就 说 明 飞 船 未 触及 屏幕 右边 缘 
( 见 @ )。 左 边缘 的 情况 与 此 类 似 : 如 果 rect 左边 缘 的 x 坐标 大 于 零 ， 就 说 明 飞 船 未 触及 屏幕 左 
边缘 ( 见 @ )。 这 确保 仅 当 飞船 在 屏幕 内 时 ， 才 调整 self.x 的 值 。 


如 果 此 时 运行 alien_invasion.py， 飞 船 将 在 触及 屏幕 左边 缘 或 右边 缘 后 停止 移动 。 真 是 太 神 
奇 了 1 只 在 if 语句 中 添加 一 个 条 件 测试 ， 就 让 飞船 在 到 达 屏 幕 左右 边缘 时 像 被 墙 挡 住 了 一 样 。 


12.6.6” 重 构 _check_events() 


随 着 游戏 的 开发 ,方法 check_events() 将 越 来 越 长 。 因 此 将 其 部 分 代码 放 在 两 个 方法 中 , 其 
中 一 个 处 理 KEYDOWN 事件 ， 另 一 个 处 理 KEYUP 事件 : 


alien_invasion.py def check events(self): 
“”“ 响 应 和 鼠标 和 按键 事件 。 ” 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 
elif event.type == pygame.KEYDOWN: 
self. check keydown events(event) 
elif event.type == pygame.KEYUP: 
self. check keyup events(event) 


def check keydown events(self, event): 
"响应 按键 。""" 
if event.key == pygame.K_RIGHT: 
self.ship.moving right = True 
elif event.key == pygame.K_LEFT: 
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self.ship.moving left = True 


def check keyup events(self, event): 
if event.key == pygame.K_RIGHT: 
self.ship.moving right = False 
elif event.key == pygame.K_LEFT: 
self.ship.moving left = False 


我 们 创建 了 两 个 新 的 辅助 方法 : check_keydown_events() 和 _check_keyup_events()。 它 们 都 包 
含 形 参 self 和 event。 这 两 个 方法 的 代码 是 从 _check_events() 中 复制 而 来 的 ， 因 此 将 方法 
_check_events() 中 相应 的 代码 蔡 换 成 了 对 这 两 个 新 方法 的 调用 。 现 在 ,方法 _check_events() 更 
简单 ， 代 码 结构 也 更 清晰 ， 在 其 中 响应 玩家 输入 时 将 更 容易 。 


12.6.7 按 Q 键 退 出 

能 够 高 效 地 响应 按键 后 ， 我 们 来 添加 另 一 种 退出 游戏 的 方式 。 当 前 ,每 次 测试 新 功能 时 ， 都 
需要 单 击 游戏 窗口 顶部 的 X 按钮 来 结束 游戏 ， 实 在 是 太 麻 烦 了 。 因 此 ， 我 们 来 添加 一 个 结束 游 
戏 的 键盘 快捷 键 Q 键 : 


alien_invasion.py def check keydown events(self, event): 
--SNip-- 
elif event.key == pygame.K_LEFT: 
self.ship.moving left = True 
elif event.key == pygame.K_q: 
sys.exit() 


在 _check_keydown_events() 中 , 添加 一 个 代码 块 , 用 于 在 玩家 按 Q 键 时 结束 游戏 。 现在 测试 
该 游戏 时 ， 你 可 按 Q 键 来 结束 游戏 ， 而 无 须 使 用 鼠标 将 窗口 关闭 。 


12.6.8 在 全 屏 模 式 下 运行 游戏 


Pygame 支持 全 屏 模式 ， 你 可 能 会 更 喜欢 在 这 种 模式 下 而 非常 规 窗 口中 运行 游戏 。 有 些 游 戏 
在 全 屏 模式 下 看 起 来 更 舒服 ， 而 在 macOS 系统 中 用 全 屏 模 式 运 行 会 提升 性 能 。 


要 在 全 屏 模 式 下 运行 该 游戏 ， 可 在 _init _() 中 做 如 下 修改 : 


alien_invasion.py def init (self): 
"" "初始 化 游戏 并 创建 游戏 资源 
pygame.init() 
self.settings = Settings() 


@ self.screen = pygame.display.set mode((0, 0), pygame.FULLSCREEN) 

@ self.settings.screen width = self.screen.get rect().width 
self.settings.screen height = self.screen.get rect().height 
pygame.display.set caption("Alien Invasion") 
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创建 屏幕 时 ， 传 人 了 尺寸 (0，0) 以 及 参数 pygame.FULLSCREEN ( 见 @ )。 这 让 Pygame 生成 一 
个 覆盖 整个 显示 器 的 屏幕 。 由 于 无 法 预先 知道 屏幕 的 宽度 和 高 度 , 要 在 创建 屏幕 后 更 新 这 些 设置 
( 见 @ ): 使 用 屏幕 的 rect 的 属性 width 和 height 来 更 新 对 象 settings。 

如 果 你 喜欢 这 款 游 戏 在 全 屏 模式 下 的 外 观 和 行为 , 请 保留 这 些 设置 。 如 果 你 更 喜欢 这 款 游 戏 
在 独立 的 窗口 中 运行 ， 可 恢复 到 原来 采用 的 方法 一 一 将 屏幕 尺寸 设置 为 特定 的 值 。 


注意 ， 在 全 屏 模 式 下 运行 这 款 游戏 之 前 ， 请 确认 能 够 按 Q 键 退出 ， 因 为 Pygame 默认 不 提供 在 
全 屏 模式 下 退出 游戏 的 方式 。 


12.7 简单 回顾 
下 一 节 将 添加 射击 功能 ,为 此 需要 新 增 一 个 名 为 bullet.py 的 文件 ， 并 修改 一 些 既 有 文件 。 当 


前 有 三 个 文件 ， 其 中 包含 很 多 类 和 方法 。 添 加 其 他 功能 之 前 ， 先 来 回顾 一 下 这 些 文件 ,让 你 清楚 
这 个 项 目的 组 织 结 构 。 


12.7.1 alien_invasion.py 


主 文件 alien_invasion.py 包含 AlienInvasion 类 。 这 个 类 创建 一 系列 贯穿 整个 游戏 都 要 用 到 
的 属性 : 赋 给 self.settings 的 设置 ， 赋 给 screen 中 的 主 显示 surface， 以 及 一 个 飞船 实例 。 这 个 
模块 还 包含 游戏 的 主 循环 ， 即 一 个 调用 _ check _events() 、ship.update() 和 _update screen() 的 
while 循环 。 

方法 check_events() 检 测 相关 的 事件 〈 如 按 下 和 松 开 键盘 )， 并 通过 调用 方法 check keydown_ 
events() 和 _check_keyup_events() 处 理 这 些 事件 。 当 前 ， 这 些 方法 负责 管理 飞船 的 移动 。 
AlienInvasion 类 还 包含 方法 _update_screen()， 该 方法 在 每 次 主 循环 中 重 绘 屏幕 。 

要 玩 游戏 《外 星人 入 侵 》 只 需 运 行文 件 alien_invasion.py， 其 他 文件 (settings.py 和 ship.py ) 
包含 的 代码 会 被 导入 这 个 文件 中 。 


12.7.2 settings.py 


文件 settings.py 包含 Settings 类 ,这 个 类 只 包含 方法 _init (),， 用 于 初始 化 控制 游戏 外 观 
和 飞船 速度 的 属性 。 


12.7.3 Sship.py 


文件 ship.py 包含 ship 类 ， 这 个 类 包含 方法 _init ()、 管 理 飞 船 位 置 的 方法 update() 和 在 屏 
幕 上 绘制 飞船 的 方法 blitme()。 表 示 飞 船 的 图 像 存储 在 文件 夹 images 下 的 文件 ship.bmp 中 。 
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动手 试 一 斌 

练习 12-3: Pygame 文 档 你 在 编写 游戏 的 道路 上 走 了 很 远 ， 可 能 想 看 看 Pygame 
文档 。 目 前， 只 需 大 致 浏览 一 下 文档 即 可 。 在 完成 本 章 项 目的 过 程 中 ,不 需要 参阅 这 些 
文档 , 但 如 果 你 想 修改 游戏 《外 星人 入 侵 》 或 编写 自己 的 游戏 , 这 些 文档 将 会 有 所 帮助 。 


练习 12-4: 火箭 “编写 一 个 游戏 ， 它 在 屏幕 中 央 显 示 一 个 火箭 ， 而 玩家 可 使 用 四 个 
方向 键 上 下 左右 移动 火箭 。 请 务必 确保 火箭 不 会 移 到 屏幕 外 面 。 


练习 12-5: 按键 ”创建 一 个 程序 ， 它 显示 一 个 空 屏幕 。 在 事件 循环 中 ， 每 当 检测 到 
pygame.KEYDOWN 事件 时 都 打印 属性 event.key。 运行 这 个 程序 并 按 各 种 键 ， 看 看 Pygame 
如 何 响应 。 


12.8 射击 


下 面 来 添加 射击 功能 。 我 们 将 编写 在 玩家 按 空 格 键 时 发 射 子弹 〈 用 小 矩形 表示 ) 的 代码 。 子 
弹 将 在 屏幕 中 向 上 飞行 ， 抵 达 屏 幕 上 边缘 后 消失 。 


12.8.1 添加 子弹 设置 
首先 ， 更 新 settings.py， 在 方法 init () 末 尾 存 储 新 类 Bullet 所 需 的 值 : 


settings.py def init (self): 
-- Snip-- 
# 子弹 设置 
self.bullet speed = 1.0 
self.bullet width = 3 


self.bullet height = 15 
self.bullet color = (60, 60, 60) 


这 些 设置 创建 宽 3 像素 、 高 15 像素 的 深 灰 色 子 弹 。 子 弹 的 速度 比 飞船 稍 低 。 
12.8.2 ”创建 Bullet 类 
下 面 来 创建 存储 Bullet 类 的 文件 bullet.py， 其 前 半 部 分 如 下 : 


bulletpy import pygame 
from pygame.sprite import Sprite 


class Bullet(Sprite): 
"" "管理 飞 船 所 发 射 子弹 的 类 """ 


def _init (self, ai game): 
""" 在 飞船 当前 位 置 创建 一 个 子弹 对 象 。""" 
super(). init () 
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self.screen = ai game.screen 
self.settings = ai game.settings 
self.color = self.settings.bullet color 


# 在 (0,0) 处 创建 一 个 表示 子弹 的 矩形 ， 再 设置 正确 的 位 置 。 


© self.rect = pygame.Rect(0, 0, self.settings.bullet width, 
self.settings.bullet height) 
2 self.rect.midtop = ai game.ship.rect.midtop 


# 存储 用 小 数 表 示 的 子弹 位 置 。 
(3 self.y = float(self.rect.y) 


Bullet 类 继承 了 从 模块 pygame.sprite 导入 的 Sprite 类 。 通 过 使 用 精灵 ( sprite )， 可 将 游戏 
中 相关 的 元 素 编组 ， 进 而 同时 操作 编组 中 的 所 有 元 素 。 为 创建 子弹 实例 ，_init () 需 要 当前 的 
AlienInvasion 实例 , 我 们 还 调用 了 super() 来 继承 Sprite。 另 外 , 我们 还 定义 了 用 于 存储 屏幕 以 
及 设置 对 象 和 子弹 颜色 的 属性 。 

在 @ 处 ， 创 建 子 弹 的 属性 rect。 子 弹 并 非 基 于 图 像 ， 因 此 必须 使 用 pygame.Rect() 类 从 头 开 
始 创 建 一 个 矩 形 。 创 建 这 个 类 的 实例 时 ， 必 须 提供 矩形 左上 角 的 x 坐标 和 yy 坐标， 以 及 和 矩形 的 宽 
度 和 高 度 。 我 们 在 (0, 0) 处 创建 这 个 矩形 , 但 下 一 行 代码 将 其 移 到 了 正确 的 位 置 ， 因为 子弹 的 初始 
位 置 取决 于 飞船 当前 的 位 置 。 子 弹 的 宽度 和 高 度 是 从 self.settings 中 获取 的 。 

在 @ 处 , 将 子弹 的 rect.midtop 设置 为 飞船 的 rect.midtop。 这 样子 弹 将 从 飞船 顶部 出 发 , 看 
起 来 像 是 从 飞船 中 射出 的 ,我 们 将 子弹 的 y 坐标 存 储 为 小 数值 , 以 便 能 够 微调 子弹 的 速度 ( 见 @ )。 


下 面 是 bullet.py 的 第 二 部 分 ， 包 括 方法 update() 和 draw_bullet(): 


bullet.py def update(self) : 
“向 上 移动 子弹 。 
# 更 新 表示 子弹 位 置 的 小 数值 。 
© self.y -= self.settings.bullet speed 
# 更 新 表示 子弹 的 Tect 的 位 置 。 
© self.rect.y = self.y 


def draw bullet(self): 
"" "在 屏幕 上 绘制 子弹 。""" 


(3 pygame.draw.rect(self.screen, self.color, self.rect) 


方法 update() 管 理子 弹 的 位 置 。 发 射出 去 后 ， 子 弹 疝 上 移动 ， 意 味 着 其 y 坐标 将 不 断 减 小 。 
为 更 新 子弹 的 位 置 ,从 self.y 中 减 去 settings .bullet speed 的 值 ( 见 @ )。 接 下 来 ,将 self.rect.y 
设置 为 self.y 的 值 ( 见 @ )。 
属性 bullet_speed 让 我 们 能 够 随 着 游戏 的 进行 或 根据 需要 提高 子弹 的 速度 ， 以 调整 游戏 的 
行为 。 子 弹 发 射 后 ， 其 坐标 始终 不 变 ， 因 此 子弹 将 沿 直线 垂直 向 上 飞行 。 

需要 绘制 子弹 时 ,我 们 调用 draw_pullet()。draw.rect() 函 数 使 用 存储 在 self.color 中 的 颜 
色 填 充 表示 子弹 的 rect 占据 的 屏幕 部 分 ( 见 @ )。 
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12.8.3 ”将 子弹 存储 到 编组 中 


定义 Bullet 类 和 必要 的 设置 后 ， 便 可 编写 代码 在 玩家 每 次 按 空格 键 时 都 射出 一 发 子弹 了 。 
我 们 将 在 AlienInvasion 中 创建 一 个 编组 ( group )， 用 于 存储 所 有 有 效 的 子弹 ， 以 便 管 理发 射出 
去 的 所 有 子弹 。 这 个 编组 是 pygame.sprite.Group 类 的 一 个 实例 。pygame.sprite.Group 类 似 于 列 
表 , 但 提供 了 有 助 于 开发 游戏 的 额外 功能 。 在 主 循环 中 , 将 使 用 这 个 编组 在 屏幕 上 绘制 子弹 以 及 
更 新 每 颗 子 弹 的 位 置 。 


首先 , 在 _init_() 中 创建 用 于 存储 子弹 的 编组 : 


alien_invasion.py def init (self): 
-- Snip-- 
self.ship = Ship(self) 
self.bullets = pygame.sprite.Group() 


然后 在 while 循环 中 更 新 子弹 的 位 置 : 


alien_invasion.py def run game(self): 
"" "开始 游 戏 主 循环 。""" 
while True: 
self. check events() 
self.ship.update() 
© self.bullets.update() 
self. update screen() 


对 编组 调用 update() 时 ( 见 @ )， 编 组 自动 对 其 中 的 每 个 精灵 调用 update()。 因 此 代码 行 
bullets.update() 将 为 编组 bullets 中 的 每 颗 子弹 调用 bullet .update()。 


12.8.4 开火 


在 AlienInvasion 中 ， 需 要 修改 _ check _keydown_events()， 以 便 在 玩家 按 空格 键 时 发 射 一 颗 
子弹 。 无 须 修改 _check_keyup_events()， 因 为 玩家 松 开 空格 键 时 什么 都 不 会 发 生 。 还 需要 修改 
_update_screen()， 确保 在 调用 flip() 前 在 屏幕 上 重 绘 每 颗 子 弹 。 


为 发 射 子弹 ， 需 要 做 的 工作 不 少 ， 因 此 编写 一 个 新 方法 fire_ bullet() 来 完成 这 项 任务 : 


alien_invasion.py -- SNip-- 
from ship import Ship 
@ from bullet import Bullet 


class AlienInvasion: 
-- SNip-- 
def check keydown events(self, event): 
=- SNip-- 
elif event.key == pygame.K_q: 
sys.exit() 
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© elif event.key == pygame.K_SPACE: 
self. fire bullet() 


def check keyup events(self, event): 
-- SNip-- 


def fire bullet(self): 
"" "创建 一 颗 子弹 ， 并 将 其 加 入 编组 bullets 中 。""" 
(3) new bullet = Bullet(self) 
@ self.bullets.add(new bullet) 


def update screen(self): 
""" 更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 
self.screen.fill(self.settings.bg color) 
self.ship.blitme() 

(3) for bullet in self.bullets.sprites(): 
bullet.draw bullet() 
pygame.display.flip() 
-- Snip-- 


首先 导入 Bullet 类 ( 见 @ )， 再 在 玩家 按 空格 键 时 调用 _fire_bullet() ( 见 @ )。 在 fire_ 


bullet() 中 ， 创 建 一 个 Bullet 实例 并 将 其 赋 给 new_bullet ( 见 @ )， 


再 使 用 方法 add() 将 其 加 入 纺 


组 bullets 中 ( 见 @ ), 方法 add() 类 似 于 append() ， 不 过 是 专门 为 Pygame 编组 编写 的 。 


方法 bullets.sprites() 返 回 一 个 列表 , 其 中 包含 编组 bullets 中 的 所 有 精灵 。 为 在 屏幕 上 绘 
制 发 射 的 所 有 子弹 ， 遍 历 编 组 bullets 中 的 精灵 ， 并 对 每 个 精灵 调用 draw bullet() ( 见 @ )。 


如 果 此 时 运行 alien_invasion.py， 将 能 够 左右 移动 飞船 ， 并 发 射 任意 数量 的 子弹 。 子 弹 在 屏 
幕 上 向 上 飞行 ,抵达 屏幕 顶部 后 消失 得 无 影 无 踪 ， 如 图 12-3 所 示 。 你 可 在 settings.py 中 修改 子弹 


的 尺寸 、 颜 色 和 速度 。 


上 


会 


图 12-3 ”飞船 发 射 一 系列 子弹 后 的 《外 星人 入 侵 》 游 戏 
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12.8.5 ”删除 消失 的 子弹 

当前 ， 子 弹 在 抵达 屏幕 顶端 后 消失 ， 但 这 仅仅 是 因为 Pygame 无 法 在 屏幕 外 面 绘制 它们 。 这 
些 子弹 实际 上 依然 存在 ， 其 y 坐标 为 负数 且 越 来 越 小 。 这 是 个 问题 ， 因 为 它们 将 继续 消耗 内 存 和 
处 理 能 力 。 

需要 将 这 些 消 失 的 子弹 删除 ， 否 则 游戏 所 做 的 无 谓 工 作 将 越 来 越 多 ,进而 变 得 越 来 越 慢 。 为 
此 ， 需 要 检测 表示 子弹 的 rect 的 bottom 属性 是 否 为 零 。 如 果 是 ， 则 表明 子弹 已 飞 过 屏幕 顶端 : 


alien_invasion.py def run game(self) : 
"" "开始 游 戏 主 循环 。""" 
while True: 
self. check events() 
self.ship.update() 
self.bullets.update() 


# 删除 消失 的 子弹 。 

for bullet in self.bullets.copy(): 
if bullet.rect.bottom <= 0: 

self.bullets.remove(bullet) 

print(len(self.bullets)) 


OO 


self. update screen() 


使 用 for 循环 遍历 列表 (或 Pygame 编组 ) 时 ，Python 要 求 该 列表 的 长 度 在 整个 循环 中 保持 
不 变 。 因 为 不 能 从 for 循环 遍历 的 列表 或 编组 中 删除 元 素 ， 所 以 必须 遍历 编组 的 副本 。 我 们 使 用 
方法 copy() 来 设置 for 循环 ( 见 @ )， 从 而 能 够 在 循环 中 修改 pullets。 我 们 检查 每 颗 子 弹 ， 看 看 
它 是 否 从 屏幕 项 端 消失 ( 见 @ )。 如 果 是 ， 就 将 其 从 pullets 中 删除 ( 见 @ )。 在 @ 处 ,使 用 函数 
调用 print() 显 示 当 前 还 有 多 少 颗 子弹 ， 以 核实 确实 删除 了 消失 的 子弹 。 


如 果 这 些 代码 没有 问题 , 我 们 发 射 子弹 后 查看 终端 窗口 时 , 将 发 现 随 着 子弹 一 颗 颗 地 在 屏幕 
顶端 消失 , 子弹 数 将 逐渐 降 为 零 。 运行 该 游戏 并 确认 子弹 被 正确 删除 后 , 请 将 这 个 函数 调用 print() 
删除 。 如 果 不 删除 , 游戏 的 速度 将 大 大 降低 ， 因 为 将 输出 写 入 终端 花费 的 时 间 比 将 图 形 绘制 到 游 
戏 窗口 花费 的 时 间 还 要 和 多。 


12.8.6 ”限制 子弹 数量 


很 多 射击 游戏 对 可 同时 出 现在 屏幕 上 的 子弹 数量 进行 了 限制 ,以 鼓励 玩家 有 目标 地 射击 。 下 
面 在 游戏 《外 星人 入侵 》 中 做 这 样 的 限制 。 


首先 ， 在 settings.py 中 存储 最 大 子弹 数 : 


settings.py # 子弹 设置 
-- Snip-- 
self.bullet color = (60, 60, 60) 
self.bullets allowed = 3 
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这 将 未 消失 的 子弹 数 限制 为 三 颗 。 在 AlienInvasion 的 fire bullet() 中 ， 在 创建 新 子弹 前 
检查 未 消失 的 子弹 数 是 否 小 于 该 设置 : 


alien_invasion.py def fire bullet(self) : 
""" 创 建新 子弹 并 将 其 加 入 编组 bullets 中 。""" 
if len(self.bullets) < self.settings.bullets allowed: 
new bullet = Bullet(self) 
self.bullets.add(new bullet) 


玩家 按 空格 键 时 ,我 们 检查 bullets 的 长 度 。 如 果 len(bullets) 小 于 3， 就 创建 一 颗 新 子弹 ; 
但 如 果 有 三 颗 未 消失 的 子弹 ， 则 玩家 按 空格 键 时 什么 都 不 会 发 生 。 如 果 现 在 运行 这 个 游戏 ,屏幕 
上 最 多 只 能 有 三 颗 子弹 。 


12.8.7 ”创建 方法 update bullets() 


写 并 检查 子弹 管理 代码 后 , 可 将 其 移 到 一 个 独立 的 方法 中 , 确保 AlienInvasion 类 组 织 有 序 。 
为 此 ， 创 建 一 个 名 为 _ update bullets() 的 新 方法 ， 并 将 其 放 在 _update _screen() 前 面 : 


讨 


alien_invasion.py def update bullets(self): 
""" 更 新 子弹 的 位 置 并 删除 消失 的 子弹 。""" 
# 更 新 子弹 的 位 置 。 
self.bullets.update() 


# 删除 消失 的 子弹 。 
for bullet in self.bullets.copy(): 
if bullet.Trect.bottom <= 0: 
self.bullets.remove(bullet) 


_update_bullets() 的 代码 是 从 run_game() 剪 切 并 粘贴 而 来 的 ， 这 里 只 是 让 注释 更 清晰 了 。 
run_game() 中 的 while 循环 又 变 得 简单 了 : 


alien_invasion.py while True: 
self. check events() 
self.ship.update() 
self. update bullets() 
self. update screen() 


我 们 让 主 循环 包含 尽 可 能 少 的 代码 , 这 样 只 要 看 方法 名 就 能 迅速 知道 游戏 中 发 生 的 情况 。 主 
循环 检查 玩家 的 输入 ,并 更 新 飞船 的 位 置 和 所 有 未 消失 子弹 的 位 置 。 然 后 ,使 用 更 新 后 的 位 置 来 
绘制 新 屏幕 。 


请 再 次 运行 alien_invasion.py， 确 认 发 射 子弹 时 没有 错误 。 
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动手 试 一 试 
练习 12-6: 侧面 射击 ”编写 一 个 游戏 ， 将 一 般 飞 船 放 在 屏幕 左 侧 ， 并 允许 玩家 上 


下 移动 飞船 。 在 玩家 按 空格 键 时 ， 让 飞船 发 射 一 颗 在 屏幕 中 向 右 飞行 的 子弹 ， 并 在 子弹 
从 屏幕 中 消失 后 将 其 删除 。 


12.9 ”小结 


在 本 章 中 ， 你 学 习 了 : 游戏 开发 计划 的 制定 ， 以 及 使 用 Pygame 编写 的 游戏 的 基本 结构 ; 如 
何 设置 背景 色 ， 以 及 如 何 将 设置 存储 在 独立 的 类 中 ， 以 便 轻 松 调整 ; 如 何在 屏幕 上 绘制 图 像 ， 以 
及 如 何 让 玩家 控制 游戏 元 素 的 移动 ; 创建 自动 移动 的 元 素 ， 如 在 屏幕 中 向 上 飞行 的 子弹 ， 以 及 删 
除 不 再 需要 的 对 象 ; 如 何 定期 重 构 项 目的 代码 ， 为 后 续 开 发 提供 便利 。 

在 第 13 音 中 ,我 们 将 在 游戏 《外 星人 和 人 侵 》 中 添加 外 星人 。 到 第 13 童 结束 时 ， 你 将 能 够 击 
落 外 星人 一 一 但 愿 是 在 其 撞 到 飞船 之 前 ! 


外 星人 来 了 


本 章 将 在 游戏 《外 星人 入 侵 》 中 添加 外 星人 。 我 们 将 首先 在 屏幕 
上 边缘 附近 添加 一 个 外 星人 , 再 生成 一 群 外 星人 。 然后 让 这 和 群 外 星人 
向 两 边 和 下 面 移动 ， 并 删除 被 子弹 击 中 的 外 星人 。 最 后 ,显示 玩家 拥 
有 的 飞船 数量 ， 并 在 玩家 的 飞船 用 完 后 结束 游戏 。 


通过 阅读 本 章 ， 你 将 更 深入 地 了 解 Pygame 和 大 型 项 目 管理 ， 还 
将 学 习 如 何 检测 游戏 对 象 之 间 的 碰撞 ， 如 子弹 和 外 星人 之 间 的 碰撞 。 
检测 碰撞 有 助 于 定义 游戏 元 素 之 间 的 交互 。 例 如, 可 以 将 角色 限定 在 
迷宫 墙壁 之 内 , 或 者 在 两 个 角色 之 间 传 球 。 我 们 将 不 时 查看 游戏 开发 
计划 ， 确 保 编程 工作 不 偏离 轨道 。 

着 手 编写 在 屏幕 上 添加 一 群 外 星人 的 代码 前 ， 先 来 回顾 一 下 这 个 项 目 ， 并 更 新 开发 
计划 。 


13.1 项 目 回 顾 


开发 大 型 项 目 时 , 要 在 进入 每 个 开发 阶段 之 前 回顾 一 下 开发 计划 , 搞 清楚 接 下 来 要 通过 编写 
代码 来 完成 哪些 任务 。 本 章 涉 及 以 下 内 容 。 

口 研究 既 有 代码 ， 确 定 实现 新 功能 前 是 否 要 重 构 。 

口 在 屏幕 左上 角 添 加 一 个 外 星人 ， 并 指定 合适 的 边 距 。 

口 根据 第 一 个 外 星人 的 边 距 和 屏幕 太 寸 计算 屏幕 上 可 容纳 多 少 个 外 星人 。 编 写 一 个 循环 来 

创建 一 系列 外 星人 ， 使 其 填 满 屏幕 的 上 半 部 分 。 

口 让 外 星人 和 群 向 两 边 和 下 方 移动 ， 直 到 外 星人 被 全 部 击落 、 有 外 星人 撞 到 飞船 或 有 外 星人 
抵达 屏幕 底 端 。 如 果 整 群 外 星人 都 被 击落 ， 将 再 创建 一 群 外 星人 。 如 果 有 外 星人 撞 到 了 
飞船 或 抵达 屏幕 底 端 ， 将 销毁 飞船 并 再 创建 一 群 外 星人 。 

口 限制 玩家 可 用 的 飞船 数量 。 当 配给 的 飞船 用 完 之 后 ， 游 戏 将 结束 。 
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我 们 将 在 实现 功能 的 同时 完善 这 个 计划 ， 但 就 目前 而 言 ， 该 计划 已 足够 详尽 。 


在 项 目 中 添加 新 功能 前 ,还 应 审核 既 有 代码 。 每 进入 一 个 新 阶段 ,项 目 通 常会 更 复杂 ， 因 此 
最 好 对 混乱 或 低 效 的 代码 进行 清理 。 我 们 一 直 在 不 断 重 构 ， 因 此 当前 没有 需要 重 构 的 代码 。 
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在 屏幕 上 放置 外 星人 与 放置 飞船 类 似 。 每 个 外 星人 的 行为 都 由 Alien 类 控制 , 我 们 将 像 创 建 
Ship 类 那样 创建 这 个 类 。 出 于 简化 考虑 , 也 将 使 用 位 图 来 表示 外 星人 。 你 可 以 自己 寻找 表示 外 星 
人 的 图 像 , 也 可 以 使 用 如 图 13-1 所 示 的 图 像 , 它 可 在 本 书 源 代 码 文件 中 找到 ( chapter_13/creating_ 
first_alien/images/alien.bmp )。 这 幅 图 像 的 背景 为 灰色 , 与 屏幕 背景 色 一 致 。 请 务必 将 选择 的 图 像 
文件 保存 到 文件 夹 images 中 。 


图 13-1 用 来 创建 外 星人 群 的 外 星人 图 像 


13.2.1 创建 Alien 类 
下 面 来 编写 Alien 类 并 将 其 保存 为 文件 alien.py: 


alien.py import pygame 
from pygame.sprite import Sprite 


class Alien(Sprite): 
"" "表示 单个 外 星人 的 类 。""" 


def init (self, ai game): 
"" "初始化 外 星人 并 设置 其 起 始 位 置 。""" 
super(). init () 


self.screen = ai game.screen 


# 加 载 外 星人 图 像 并 设置 其 Tect 属性 。 
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self.image = pygame.image.1oad(' images/alien.bmp ') 
self.rect = self.image.get rect() 


# 每 个 外 星人 最 初 部 在 屏幕 左上 角 附 近 。 
© self.rect.x = self.rect.width 
self.rect.y = self.rect.height 


# 存储 外 星人 的 精确 水 平 位 置 。 
© self.x = float(self.rect.x) 


除 位 置 不 同 外 ， 这 个 类 的 大 部 分 代码 与 ship 类 相似 。 每 个 外 星人 最 初 都 位 于 屏幕 左上 角 附 近 。 
将 每 个 外 星人 的 左边 距 都 设置 为 外 星人 的 宽度 , 并 将 上 边 距 设置 为 外 星人 的 高 度 ( 见 @ ), 这 样 更 容 
易 看 清 。 我 们 主要 关心 的 是 外 星人 的 水 平 速度 ， 因 此 精确 地 记录 了 每 个 外 星人 的 水 平 位 置 ( 见 @ )。 


Alien 类 不 需要 一 个 在 屏幕 上 绘制 外 星人 的 方法 ， 因 为 我 们 将 使 用 一 个 Pygame 编组 方法 ， 
自动 在 屏幕 上 绘制 编组 中 的 所 有 元 素 。 


13.2.2 ”创建 Alien 实例 

要 让 第 一 个 外 星人 在 屏幕 上 现 身 , 需要 创建 一 个 Alien 实例 。 这 属于 设置 工作 ， 因 此 将 把 这 
些 代码 放 在 AlienInvasion 类 的 方法 _init () 末 尾 。 我 们 最 终 会 创建 一 群 外 星人 ， 涉 及 的 工作 
量 不 少 ， 因 此 将 新 建 一 个 名 为 _ create fleet() 的 辅助 方法 。 

在 类 中 , 方法 的 排列 顺序 无 关 紧 要 ， 只 要 按 统一 的 标准 排列 就 行 。 我 们 将 把 _create_fleet () 
放 在 _update_screen() 前 面 ， 不 过 放 在 AlienInvasion 类 的 任何 地 方 其 实 都 可 行 。 首 先 ， 需 要 导 
入 Alien 类 。 


下 面 是 alien_invasion.py 中 修改 后 的 import 语句 : 


alien_invasion.py -- 5s/N1p-- 
from bullet import Bullet 
from alien import Alien 


下 面 是 修改 后 的 方法 _ init_(): 


alien_invasion.py def init (self): 
-- Ship-- 
self.ship = Ship(self) 
self.bullets = pygame.sprite.Group() 
self.aliens = pygame.sprite.Group() 


self. create fleet() 


创建 了 一 个 用 于 存储 外 星人 群 的 编组 ， 还 调用 了 接 下 来 将 编写 的 方法 _create fleet()。 
下 面 是 新 编写 的 方法 _create_fleet(): 
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alien_invasion.py def create fleet(self) : 
"" "创建 外 星人 群 。""" 
# 创建 一 个 外 星人 。 
alien = Alien(self) 
self.aliens.add(alien) 


在 这 个 方法 中 , 创建 了 一 个 Alien 实例 ， 再 将 其 添加 到 用 于 存储 外 星人 群 的 编组 中 。 外 星人 
默认 放 在 屏幕 左上 角 附近 ， 对 第 一 个 外 星人 来 说 ， 这 样 的 位 置 非常 合适 。 
要 让 外 星人 现 身 ， 需 要 在 update screen() 中 对 外 星人 编组 调用 方法 draw(): 


alien_ invasion.py def update screen(self): 
-- Snip-- 
for bullet in self.bullets.sprites(): 
bullet.draw bullet() 
self.aliens.draw(self.screen) 


pygame.display.flip() 


对 编组 调用 draw() 时 ，Pygame 将 把 编组 中 的 每 个 元 素 绘制 到 属性 rect 指定 的 位 置 。 方 法 
draw() 接 受 一 个 参数 ， 这 个 参数 指定 了 要 将 编组 中 的 元 素 绘制 到 哪个 surface 上 。 图 13-2 显示 了 
在 屏幕 上 现 身 的 第 一 个 外 星人 。 


® Alien Invasion 


会 
图 13-2 第 一 个 外 星人 现 身 


第 一 个 外 星人 正确 地 现 身 了 ， 下 面 来 编写 绘制 一 群 外 星人 的 代码 。 
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13.3 ”创建 一 群 外 星人 


要 绘制 一 群 外 星人 , 需要 确定 一 行 能 容纳 多 少 个 外 星人 以 及 要 绘制 多 少 行 。 我 们 将 首先 计算 
外 星人 的 水 平 间距 并 创建 一 行 外 星人 ， 再 确定 可 用 的 垂直 空间 并 创建 整 群 外 星人 。 


13.3.1 ”确定 一 行 可 容纳 多 少 个 外 星人 

为 确定 一 行 可 容纳 多 少 个 外 星人 , 来 看 看 可 用 的 水 平 空间 有 多 大 。 屏幕 宽度 存储 在 settings. 
screen_width 中， 但 需要 在 屏幕 两 边 都 留 下 一 定 的 边 距 (将 其 设置 为 外 星人 的 宽度 )。 因 为 有 两 
个 边 距 ， 所 以 可 用 于 放置 外 星人 的 水 平 空间 为 屏幕 宽度 减 去 外 星人 宽度 的 两 倍 : 


available space x = settings.screen width - (2 * alien width) 


还 需要 在 外 星人 之 间 留 出 一 定 的 空间 ,不妨 将 其 定 为 外 星人 的 宽度 。 因 此 , 显示 一 个 外 星人 
所 需 的 水 平 空 间 为 外 星人 宽度 的 两 倍 : 一 个 宽度 用 于 放置 外 星人 , 另 一 个 宽度 为 外 星人 右边 的 空 
白 区 域 。 为 确定 一 行 可 容纳 多 少 个 外 星人 ， 将 可 用 空间 除 以 外 星人 宽度 的 两 倍 。 我 们 使 用 整除 
( floor division ) 运算 符 //, 它 将 两 个 数 相 除 并 丢弃 余数 , 让 我 们 得 到 一 个 表示 外 星人 个 数 的 整数 。 


number aliens x = available space x // (2 * alien width) 


我 们 将 在 创建 外 星人 群 时 使 用 这 些 公式 。 


注意 令 人 欣 奈 的 是 ， 在 程序 中 执行 计算 时 ， 无 须 在 一 开始 确定 公式 是 正确 的 ， 而 是 可 以 尝试 
运行 程序 ， 看 看 结果 是 否 符合 预期 。 即 便 是 在 最 坏 的 情况 下 ， 也 只 是 屏幕 上 显示 的 外 星 
人 大多 或 太 少 。 随 后 可 根据 在 屏幕 上 看 到 的 情况 调整 计算 公式 。 
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现在 可 以 创建 整 行 外 星人 了 。 由 于 创建 单个 外 星人 的 代码 管用 ,我 们 重 写 _create_fleet() 
使 其 创建 一 行 外 星人 : 


alien_ invasion.py def create fleet(self): 

""" 创 建 外 星人 群 。""" 

# 创建 一 个 外 星人 并 计算 一 行 可 容纳 多 少 个 外 星人 。 

# 外 星人 的 间距 为 外 星人 宽度 。 

alien = Alien(self) 

alien width = alien.rect.width 

available space x = self.settings.screen width - (2 * alien width) 
number aliens x = available space x // (2 * alien width) 


@Q@Oe 


# 创建 第 一 行 外 星人 。 
Q@ for alien number in range(number aliens x): 
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# 创建 一 个 外 星人 并 将 其 加 入 当前 行 。 
alien = Alien(self) 
© alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 
self.aliens.add(alien) 


这 些 代 码 大 多 在 前 面 详细 介绍 过 。 为 放置 外 星人 , 需要 知道 外 星人 的 宽度 和 高 度 ， 因 此 在 执 
行 计算 前 ,创建 一 个 外 星人 ( 见 @ )。 这 个 外 星人 不 是 外 星人 群 的 成 员 ， 因 此 没有 将 其 加 入 编组 
aliens 中 。 在 @ 处 ， 从 外 星人 的 rect 属性 中 获取 外 星人 宽度 ， 并 将 这 个 值 存储 到 alien_width 
中 ,以 免 反 复 访 问 属性 rect。 在 @ 处 , 计算 可 用 于 放置 外 星人 的 水 平 空间 以 及 其 中 可 容纳 多 少 个 
外 星人 。 


接 下 来 ,编写 一 个 循环 ， 从 零 数 到 要 创建 的 外 星人 数 ( 见 @ )。 在 这 个 循环 中 ,创建 一 个 新 
的 外 星人 ， 并 通过 设置 x 坐标 将 其 加 入 当前 行 ( 见 @ )。 将 每 个 外 星人 都 往 右 推 一 个 外 星人 宽度 。 
接 下 来 ， 将 外 星人 宽度 乘 以 2， 得 到 每 个 外 星人 占据 的 空间 ( 其 中 包括 右边 的 空白 区 域 )， 再 据 
此 计算 当前 外 星人 在 当前 行 的 位 置 。 我 们 使 用 外 星人 的 属性 x 来 设置 其 rect 的 位 置 。 最 后 ， 将 
每 个 新 创建 的 外 星人 都 添加 到 编组 aliens 中 。 


如 果 现 在 运行 这 个 游戏 ， 将 看 到 第 一 行 外 星人 ， 如 图 13-3 所 示 。 
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会 
图 13-3 第 一 行 外 星人 


这 行 外 星人 在 屏幕 上 稍微 偏向 了 左边 、 这 实际 上 是 有 好 处 的 , 因为 后 面 将 让 外 星人 群 往 右 移 ， 
触及 屏幕 边缘 后 稍微 往 下 移 ， 再 往 左 移 ， 依 此 类 推 。 就 像 经 典 游戏 《太空 人 侵 者 》 相 比 于 只 往 
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下 移 , 这 种 移动 方式 更 为 有 趣 。 我们 将 让 外 星人 群 不 断 这 样 移动 ， 直 到 所 有 外 星人 都 被 击落 ,或 
者 有 外 星人 撞 上 飞船 或 抵达 屏幕 底 端 。 


注意 根据 所 选择 的 屏幕 宽度 ， 在 你 的 系统 中 ， 第 一 个 外 星人 的 位 置 可 能 稍 有 不 同 。 


13.3.3 重 构 create fleet() 


倘若 只 需 使 用 前 面 的 代码 就 能 创建 外 星人 群 , 也 许 应 该 让 _create_fleet() 保 持原 样 , 但 鉴于 
创建 外 星人 群 的 工作 还 未 完成 ， 我 们 稍微 整理 一 下 这 个 方法 。 为 此 ， 添加 辅助 方法 
_create alien()， 并 在 _create fleet() 中 调用 它 : 


alien_invasion.py def create fleet(self): 
--Snip-- 
# 创建 第 一 行 外 星人 。 
for alien number in range(number aliens x): 
self. create alien(alien number) 


def create alien(self, alien number): 
""" 创 建 一 个 外 星人 并 将 其 放 在 当前 行 。""" 
alien = Alien(self) 
alien width = alien.rect.width 
alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 
self.aliens.add(alien) 


除 self 外 ,方法 _create_alien() 还 接受 男 一 个 参数 ， 即 要 创建 的 外 星人 的 编号 。 该 方法 的 
代码 与 _create_fleet() 相 同 , 但 在 内 部 获取 外 星人 宽度 , 而 不 是 将 其 作为 参数 传人 。 这 样 重 构 后 ， 
添加 新 行进 而 创建 整 群 外 星人 将 更 容易 。 


13.3.4 添加 行 

要 创建 外 星人 群 , 需要 计算 屏幕 可 容纳 多 少 行 , 并 将 创建 一 行 外 星人 的 循环 重复 执行 相应 的 
次 数 。 为 计算 可 容纳 的 行 数 ， 要 先 计算 可 用 的 垂直 空间 : 用 屏幕 高 度 减 去 第 一 行 外 星人 的 上 边 距 
(外 星人 高 度 )、 飞 船 的 高 度 以 及 外 星人 群 最 初 与 飞船 之 间 的 距离 ( 外 星人 高 度 的 两 售 ): 


available space y = settings.screen height - (3 * alien height) - ship height 


这 将 在 飞船 上 方 留 出 一 定 的 空白 区 域 ， 给 玩家 留 出 射 杀 外 星人 的 时 间 。 


每 行 下 方 都 要 留 出 一 定 的 空白 区 域 ， 不 妨 将 其 设置 为 外 星人 的 高 度 。 为 计算 可 容纳 的 行 数 ， 
将 可 用 的 垂直 空间 除 以 外 星人 高 度 的 两 倍 。 我 们 使 用 整除 ， 因 为 行 数 只 能 是 整数 。( 同样 ， 如 果 
这 样 的 计算 不 对 ， 我 们 马上 就 能 发 现 ， 继 而 将 间距 调整 为 合理 的 值 。) 
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alien_invasion.py 


number rows = available space y // (2 * alien height) 


知道 可 容纳 多 少 行 之 后 ， 便 可 重复 执行 创建 一 行 外 星人 的 代码 了 : 


def 


def 


_create fleet(self): 


-- Snip-- 

alien = Alien(self) 

alien width, alien height = alien.rect.size 

available space x = self.settings.screen width - (2 * alien width) 
number aliens x = available space x // (2 * alien width) 


# 计算 屏幕 可 容纳 多 少 行 外 星人 。 
ship height = self.ship.rect.height 
available space y = (self.settings.screen height - 
(3 * alien height) - ship height) 
number Tows = available space y // (2 * alien height) 


# 创建 外 星人 群 。 
for row number in range(number rows): 

for alien number in range(number aliens x): 
self. create alien(alien number, row number) 


_create alien(self, alien number, row number): 

""" 创 建 一 个 外 星人 ， 并 将 其 放 在 当前 行 

alien = Alien(self) 

alien width, alien height = alien.rect.size 

alien.x = alien width + 2 * alien width * alien number 

alien.rect.x = alien.x 

alien.rect.y = alien.rect.height + 2 * alien.rect.height * row number 
self.aliens.add(alien) 


需要 知道 外 星人 的 宽度 和 高 度 , 因此 在 @ 人 处 使 用 了 属 怕 


E size。 该 属性 是 一 个 元 组 , 包含 rect ma 


对 象 的 宽度 和 高 度 。 为 计算 屏幕 可 容纳 多 少 行 外 星人 ,在 计算 available_space x 的 代码 后 面 添 
加 了 计算 available space y 的 代码 ( 见 @ )。 此 处 将 计算 公式 用 圆 括 号 括 起 来 ， 以 便 将 代码 分 成 
两 行 ， 遵 循 每 行 不 超过 79 字符 的 建议 。 
为 创建 多 行 外 星人 ， 使 用 了 两 个 读 套 在 一 起 的 循环 : 一 个 外 部 循环 和 一 个 内 部 循环 ( 见 目 )。 
内 部 循环 创建 一 行 外 星人 ,而 外 部 循环 从 零 数 到 要 创建 的 外 星人 行 数 : Python 将 重复 执行 创建 单 
行 外 星人 的 代码 ， 重 复 次 数 为 number rows。 
为 嵌 套 循环 ,编写 了 一 个 新 的 for 循环 ， 并 缩 进 了 要 重复 执行 的 代码 。( 在 大 多 数 文本 编辑 
器 中 ， 缩 进 代 码 块 和 取消 缩 进 都 很 容易 ， 详 情 请 参阅 附录 B )。 现 在 调用 _ create alien() 时 , 传 
递 了 一 个 表示 行 号 的 实 参 ， 将 每 行 都 治 屏幕 依次 向 下 放置 。 
在 _create alien() 的 定义 中 ， 需 要 一 个 用 于 存储 行 号 的 形 参 。 在 _create alien() 中 ， 修 改 
外 星人 的 ?坐标 ( 见 @ ) 并 在 第 一 行 外 星人 上 方 留 出 与 外 星人 等 高 的 空白 区 域 。 相 邻 外 星人 行 的 


坐标 相差 外 星人 高 度 的 两 倍 ,， 因 此 将 外 星人 高 度 乘 以 2， 再 乘 以 行 号 。 第 一 行 的 行 号 为 0, 因此 
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第 一 行 的 垂直 位 置 不 变 ， 而 其 他 行 都 沿 屏幕 依次 向 下 放置 。 
如 果 现 在 运行 这 个 游戏 ,将 看 到 一 群 外 星人 ， 如 图 13-4 所 示 。 


Alien Invasion 


心 


图 13-4 ” 整 群 外 星人 都 现 身 了 
下 一 市 将 让 外 星人 群 动 起 来 ! 


动手 试 一 斌 
练习 13-1: 星星 找 一 幅 星星 图 像 ， 并 在 屏幕 上 显示 一 系列 整齐 排列 的 星星 。 


练习 13-2: 更 逼真 的 星星 为 让 星星 的 分 布 更 逼真 ， 可 随机 地 放置 星星 。 本 书 前 面 
说 过 ， 可 像 下 面 这 样 来 生成 随机 数 : 


from random import randint 
random number = randint(-10, 10) 


上 述 代 码 返 回 一 个 -10 和 10 之 间 的 随机 整数 ,在 为 完成 练习 13-1 而 编写 的 程序 中 ， 
随机 地 调整 每 颗 星 星 的 位 置 。 
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13.4 让 外 星人 群 移动 


下 面 来 让 外 星人 群 在 屏幕 上 向 右 移动 , 撞 到 屏幕 边缘 后 下 移 一 定 的 量 , 再 沿 相反 的 方向 移动 。 
我 们 将 不 断 移 动 所 有 的 外 星人 , 直到 外 星人 被 全 部 消灭 ,或 者 有 外 星人 撞 上 飞船 或 抵达 屏幕 底 端 。 
下 面 先 让 外 星人 向 右 移 动 。 


13.4.1 ”向 右 移动 外 星人 群 


为 移动 外 星人 群 ， 将 使 用 alien.py 中 的 方法 update()。 对 于 外 星人 群 中 的 每 个 外 星人 ， 都 要 
调用 它 。 首 先 ， 添加 一 个 控制 外 星人 速度 的 设置 : 


settings.py def init (self): 
--SNnip-- 
# 外 星人 设置 
self.alien speed = 1.0 


再 使 用 这 个 设置 来 实现 update(): 


alien.py def init (self, ai game): 
"" "初始化 外 星人 并 设置 其 初始 位 置 。""" 
super(). init () 


self.screen = ai game.screen 
self.settings = ai game.settings 
--Snip-- 


def update(self): 
mm 向 右 移动 外 星人 。""" 
self.x += self.settings.alien speed 
self.rect.x = self.x 


@e 


在 _init_() 中 添加 了 属性 settings， 以 便 能 够 在 update() 中 访问 外 星人 的 速度 。 每 次 更 新 外 
星人 时 ， 都 将 它 向 右 移动 ， 移 动量 为 alien_speed 的 值 。 我 们 使 用 属性 self.x 跟踪 每 个 外 星人 的 准 
确 位 置 , 该 属性 可 存储 小 数值 ( 见 @ ), 然后 , 使 用 self.x 的 值 来 更 新 外 星人 的 rect 的 位 置 ( 见 @ )。 


主 while 循环 中 已 调用 了 更 新 飞船 和 子弹 的 方法 ,现在 还 需 更 调用 更 新 每 个 外 星人 位 置 的 方法 : 


alien_invasion.py while True: 
self. check events() 
self.ship.update() 
self. update bullets() 
self. update aliens() 
self. update screen() 


需要 编写 一 些 代码 来 管理 外 星人 群 的 移动 ， 因 此 新 建 一 个 名 为 _update_aliens() 的 方法 。 我 
们 在 更 新 子弹 后 再 更 新 外 星人 的 位 置 ， 因 为 稍 后 要 检查 是 否 有 子弹 击 中 了 外 星人 。 
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将 这 个 方法 放 在 模块 的 什么 地 方 都 无 关 紧 要 ， 但 为 确保 代码 组 织 有 序 ， 我 将 它 放 在 方法 
_update_bullets() 的 后 面 ， 以 便 与 while 循环 中 的 调用 顺序 一 致 。 下 面 是 _update_aliens() 的 第 
一 版 : 


alien_invasion.py def update aliens(self): 
mm 更 新 外 星人 群 中 所 有 外 星人 的 位 置 。 """ 
self.aliens.update() 


对 编组 调用 方法 update(), 这 将 自动 对 每 个 外 星人 调用 方法 update()。 如 果 现 在 运行 这 个 游 
戏 ， 你 将 看 到 外 星人 群 向 右 移 动 ， 并 在 屏幕 右边 缘 消失 。 


13.4.2 ”创建 表示 外 星人 移动 方向 的 设置 


下 面 来 创建 让 外 星人 撞 到 屏幕 右边 缘 后 向 下 移动 、 再 向 左 移动 的 设置 。 实 现 这 种 行为 的 代码 
如 下 : 


settings.py # 外 星人 设置 
self.alien speed = 1.0 
self.fleet drop speed = 10 
# fleet direction 为 1 表示 向 右 移 ， 为 -1 表示 向 左 移 。 
self.fleet direction = 1 


设置 fleet_drop_speed 指定 有 外 星人 撞 到 屏幕 边缘 时 , 外 星人 群 向 下 移动 的 速度 。 将 这 个 速 
度 与 水 平 速度 分 开 是 有 好 处 的 ， 便 于 分 别 调整 这 两 个 速度 。 

要 实现 设置 fleet_direction， 可 将 其 设置 为 文本 值 ， 如 'left ' 或 'right' ， 但 这 样 就 必须 编 
写 if-elif 语句 来 检查 外 星人 群 的 移动 方向 。 鉴 于 只 有 两 个 可 能 的 方向 , 我 们 使 用 值 1 和 -1 来 表 
示 ， 并 在 外 星人 群 改变 方向 时 在 这 两 个 值 之 间 切 换 。( 向 右 移 时 需要 增 大 每 个 外 星人 的 x 坐标 ， 
而 向 左 移 时 需要 减 小 每 个 外 星人 的 x 坐标， 因此 使 用 数字 来 表示 方向 十 分 合理 。 ) 


13.4.3 ”检查 外 星人 是 否 撞 到 了 屏幕 边缘 


现在 需要 编写 一 个 方法 来 检查 外 星人 是 否 撞 到 了 屏幕 边缘 , 还 需 修改 update() 让 每 个 外 星人 
都 沿 正确 的 方向 移动 。 这 些 代 码 位 于 Alien 类 中 : 


alien.py def check edges(self): 
""" 如 果 外 星人 位 于 屏幕 边缘 ， 就 返回 True。""" 
screen rect = self.screen.get rect() 
© if self.rect.right >= screen rect.right or self.rect.left “= 0: 
return True 


def update(self) : 
mu 向 左 或 向 右 移动 外 星人 人 。""" 
@ self.x += (self.settings.alien speed * 
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self.settings.fleet direction) 
self.rect.x = self.x 


可 对 任意 外 星人 调用 新 方法 check_edges() ， 看 其 是 否 位 于 屏幕 左边 缘 或 右边 缘 。 如 果 外 星 
人 的 rect 的 属性 right 大 于 或 等 于 屏幕 的 rect 的 right 属性 ， 就 说 明 外 星人 位 于 屏幕 右边 缘 ; 
如 果 外 星人 的 rect 的 left 属性 小 于 或 等 于 0， 就 说 明 外 星人 位 于 屏幕 左边 缘 ( 见 @ )。 


我 们 修改 方法 update() ， 将 移动 量 设置 为 外 星人 速度 和 fleet_direction 的 乘积 ， 让 外 星人 
问 左 或 问 右 移动 ( 见 @ )。 如 果 fleet direction 为 1, 就 将 外 星人 的 当前 x 坐标 增 大 alien_speed， 
从 而 将 外 星人 向 右 移 ; 如果 人 eet_direction 为 -1， 就 将 外 星人 的 当前 x 坐标 减 去 alien_speed， 
从 而 将 外 星人 向 左 移 。 


13.4.4 ”向 下 移动 外 星人 群 并 改变 移动 方向 


有 外 星人 到 达 屏 幕 边缘 时 , 需要 将 整 群 外 行星 下 移 ， 并 改变 它们 的 移动 方向 。 为 此 ,需要 在 
AlienInvasion 中 添加 一 些 代码 ， 因 为 要 在 这 里 检查 是 否 有 外 星人 到 达 了 左边 缘 或 右边 缘 。 我 们 
编写 方法 check fleet edges() 和 _ change fleet direction(), 并 且 修 改 update aliens()。 这 些 
新 方法 将 放 在 _create alien() 后 面 ,但 其 实 放 在 AlienInvasion 类 中 的 什么 位 置 都 无 关 紧 要 : 


alien_invasion.py def check fleet edges(self): 
""" 有 外 星人 到 达 边 缘 时 采取 相应 的 措施 。""" 
@ for alien in self.aliens.sprites(): 
if alien.check edges(): 
© self. change fleet direction() 
break 


def change fleet direction(self): 
""" 将 整 群 外 星人 下 移 ， 并 改变 它们 的 方向 。""” 
for alien in self.aliens.sprites(): 
日 alien.rect.y += self.settings.fleet drop speed 
self.settings.fleet direction *= -1 


在 _check fleet edges() 中 ,遍历 外 星人 群 并 对 其 中 的 每 个 外 星人 调用 check_edges() ( 见 @ )。 
如 果 check_edges() 返 回 True， 就 表明 相应 的 外 星人 位 于 屏幕 边缘 ， 需 要 改变 外 星人 和 群 的 方向 ， 
因此 调用 _ change_ fleet direction() 并 退出 循环 ( 见 @ )。 在 change fleet direction() 中 ， 遍 
历 所 有 外 星人 , 将 每 个 外 星人 下 移 设置 feet _ drop_speed 的 值 ( 见 @ )。 然 后 , 将 fleet direction 
的 值 改 为 其 当前 值 与 -1 的 乘积 。 调 整 外 星人 群 移动 方向 的 代码 行 没有 包含 在 for 循环 中 ， 因 为 
我 们 要 调整 每 个 外 星人 的 垂直 位 置 ， 但 只 想 调整 外 星人 群 移动 方向 一 次 。 


下 面 显示 了 对 _update_aliens() 所 做 的 修改 ; 


alien_invasion.py def update aliens(self): 


检查 是 否 有 外 星人 位 于 屏幕 边缘 ， 
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并 更 新 整 群 外 星人 的 位 置 。 


self. check fleet edges() 
self.aliens.update() 


我 们 将 方法 _update_aliens() 修 改 成 了 先 调用 _check fleet edges()， 再 更 新 每 个 外 星人 的 
位 置 。 

如 果 现 在 运行 这 个 游戏 ， 外 星人 和 群 将 在 屏幕 上 来 回 移动 , 并 在 抵达 屏幕 边缘 后 向 下 移动 。 现 
在 可 以 开始 射 杀 外 星人 ， 并 检查 是 否 有 外 星人 撞 到 飞船 或 抵达 了 屏幕 底 端 。 


动手 试 一 试 
练习 13-3: 雨滴 ”寻找 一 幅 雨 滴 图 像 ， 并 创建 一 系列 整齐 排列 的 雨滴 。 让 这 些 雨 滴 


往 下 落 ， 直 到 到 达 屏 幕 底 端 后 消失 。 
练习 13-4: 连绵 细 雨 修改 为 完成 练习 11-3 而 编写 的 代码 ， 使 得 一 行 雨滴 消失 在 
屏幕 底 端 后 ， 屏 幕 顶端 又 出 现 一 行 新 雨滴 并 开始 往 下 落 。 


13.5 ” 射 杀 外 星人 


我 们 创建 了 飞船 和 外 星人 群 ,但 子弹 击 中 外 星人 时 将 穿 过 外 星人 ， 因 为 还 没有 检查 碰撞 。 在 
游戏 编程 中 ， 碰 撞 指 的 是 游戏 元 素 重 县 在 一 起 。 要 让 子弹 能 够 击落 外 星人 ， 我 们 将 使 用 
sprite.groupcollide() 检 测 两 个 编组 的 成 员 之 间 的 碰撞 。 


13.5.1 ”检测 子弹 与 外 星人 的 碰撞 

子弹 击 中 外 星人 时 ,我 们 需要 马上 知道 ， 以 便 碰撞 发 生 后 让 子弹 立即 消失 。 为 此 ,我 们 将 在 
更 新 子弹 的 位 置 后 立即 检测 碰撞 。 

函数 sprite.groupcollide() 将 一 个 编组 中 每 个 元 素 的 rect 同 男 一 个 编组 中 每 个 元 素 的 rect 
进行 比较 。 在 这 里 ， 是 将 每 颗 子 弹 的 rect 同 每 个 外 星人 的 rect 进行 比较 ， 并 返回 一 个 字典 ， 其 
中 包含 发 生 了 碰撞 的 子弹 和 外 星人 。 在 这 个 字典 中 ,每 个 键 都 是 一 颗 子 弹 ， 而 关联 的 值 是 被 该 子 
弹 击 中 的 外 星人 (第 14 章 实现 记分 系统 时 ， 也 将 使 用 该 字典 )。 

在 方法 _update_bullets() 末 尾 ， 添 加 如 下 检查 子弹 和 外 星人 磁 撞 的 代码 : 


| 


alien_invasion.py def update bullets(self): 
""" 更 新 子弹 的 位 置 ， 并 删除 消失 的 子弹 。""" 
-- Snip-- 
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# 检查 是 否 有 子弹 击 中 了 外 星人 。 

# 如 果 是 ， 就 删除 相应 的 子弹 和 外 星人 。 

collisions = pygame.sprite.groupcollide( 
self.bullets, self.aliens, True, True) 


这 些 新 增 的 代码 将 self.bullets 中 所 有 的 子弹 都 与 self.aliens 中 所 有 的 外 星人 进行 比较 ， 
看 它们 是 否 重 闭 在 一 起 。 每 当 有 子弹 和 外 星人 的 rect 重 赤 时 ,groupcollide() 就 在 它 返回 的 字典 
中 添加 一 个 键 值 对 。 两 个 实 参 True 让 Pygame 删除 发 生 碰撞 的 子弹 和 外 星人 。( 要 模拟 能 够 飞行 
到 屏幕 顶端 、 消 灭 击 中 的 每 个 外 星人 的 高 能 子弹 ， 可 将 第 一 个 布尔 实 参 设 置 为 False， 并 保留 第 
二 个 布尔 参数 为 True。 这样 被 击 中 的 外 星人 将 消失 , 但 所 有 的 子弹 都 始终 有 效 , 直到 抵达 屏幕 项 
端 后 消失 。) 

如 果 此 时 运行 这 个 游戏 ， 被 击 中 的 外 星人 将 消失 。 如 图 13-5 所 示 ， 有 些 外 星人 被 射 杀 了 。 


® Alien Invasion 


会 


图 13-5 可 以 射 杀 外 星人 了 


13.5.2 ”为 测试 创建 大 子弹 
只 需 运 行 这 个 游戏 就 可 测试 很 多 功能 ， 但 有 些 功能 在 正常 情况 下 测试 起 来 比较 烦琐 。 例如， 
要 测试 代码 能 否 正确 处 理 外 星人 编组 为 空 的 情形 , 需要 花 很 长 时 间 将 屏幕 上 的 外 星人 全 部 射 杀 。 
测试 有 些 功能 时 ,可 以 修改 游戏 的 某 些 设置 ， 以 便 能 够 专注 于 游戏 的 特定 方面 。 例 如， 可 以 
缩小 屏幕 以 减少 需要 射 杀 的 外 星人 数量 , 也 可 以 提高 子弹 的 速度 ,以 便 能 够 在 单位 时 间 内 发 射 大 
量子 弹 。 
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测试 这 个 游戏 时 ， 我 喜欢 做 的 一 项 修改 是 ， 增 大 子弹 的 尺寸 并 使 其 在 击 中 外 星人 后 依然 有 
效 ， 如 图 13-6 所 示 。 请 尝试 将 bullet width 设置 为 300 乃至 3000， 看 看 将 所 有 外 星人 全 部 射 杀 
有 多 快 ! 


Alien Invasion 


人 


2 


图 13-6 威力 超 强 的 子弹 让 游戏 的 有 些 方法 测试 起 来 更 容易 


这 样 的 修改 可 提高 测试 效率 ， 还 可 能 激发 出 如 何 赋予 玩家 更 大 威力 的 思想 火花 。( 完成 测试 
后 ， 别 忘 了 将 设置 恢复 正常 。) 


13.5.3 生成 新 的 外 星人 群 

这 个 游戏 的 一 个 重要 特点 是 ， 外 星人 无 穷 无 尽 : 一 群 外 星人 被 消灭 后 ， 又 会 出 现 另 一 群 外 
星人 。 

要 在 一 群 外 星人 被 消灭 后 再 显示 一 群 外 星人 人， 首先 需 要 检查 编组 aliens 是 否 为 空 。 如 果 是 ， 
就 调用 _ create fleet()。 我 们 将 在 _ update_bullets() 末 尾 执行 这 项 任务 ， 因 为 外 星人 都 是 在 这 


里 被 消灭 的 : 
alien_invasion.py def update _ bullets(self) : 
-- Snip-- 
@ if not self.aliens: 
# 删除 现 有 的 子弹 并 新 建 一 群 外 星人 。 
@ self.bullets.empty() 


self. create fleet() 
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在 @ 处 ,检查 编组 aliens 是 否 为 空 。 空 编组 相当 于 False， 因 此 这 是 一 种 检查 编组 是 否 为 空 
的 简单 方式 。 如 果 编 组 aliens 为 空 ， 就 使 用 方法 empty() 删 除 编组 中 余下 的 所 有 精灵 ， 从 而 删除 
现 有 的 所 有 子弹 ( 见 @ )。 我 们 还 调用 了 _create fleet() ， 在 屏幕 上 重新 显示 一 群 外 星人 。 


现在 ， 当 前 这 群 外 星人 被 消灭 干净 后 ， 将 立刻 出 现 一 群 新 的 外 星人 。 


13.5.4 ”提高 子弹 的 速度 
如 果 现 在 尝试 在 游戏 中 射 杀 外 星人 ， 可 能 会 发 现 子弹 的 速度 不 太 合 适 ( 有 点 快 或 有 点 慢 )， 
游戏 感 不 好 。 当 前 ， 可 通过 修改 设置 让 这 款 游戏 更 有 意思 、 更 好 玩 。 


要 修改 子弹 的 速度 ,可 调整 settings.py 中 bullet_speed 的 值 。 在 我 的 系统 中 , 我 把 bullet speed 
的 值 调 整 到 1.5， 让 子弹 的 速度 快 些 : 


settings.py # 子弹 设置 
self.bullet speed 
self.bullet width = 3 
-- Snip-- 


ll 
| 
un 


这 项 设置 的 最 佳 值 取 决 于 你 使 用 的 系统 的 速度 ,请 找 出 适合 自己 的 值 。 你 也 可 以 调整 其 他 
设置 。 


13.5.5” 重 构 _update_bullets() 


下 面 来 重 构 _update_bullets(), 使 其 不 再 执行 那么 多 任务 。 为 此 , 将 处 理子 弹 和 外 星人 碰撞 
的 代码 移 到 一 个 独立 的 方法 中 : 


alien_invasion.py def update bullets(self) : 
=- SNip-- 
# 删除 消失 的 子弹 。 
for bullet in self.bullets.copy(): 
if bullet.rect.bottom <= 0: 
self.bullets.remove(bullet) 


self. check bullet alien collisions() 


def check bullet alien collisions(self): 
""" 响 应 子弹 和 外 星人 碰撞 。""" 
# 删除 发 生 碰撞 的 子弹 和 外 星人 。 


collisions = pygame.sprite.groupcollide( 
self.bullets, self.aliens, True, True) 


if not self.aliens: 
# 删除 现 有 的 所 有 子弹 ， 并 创建 一 群 新 的 外 星人 
self.bullets.empty() 
self. create fleet() 
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我 们 创建 了 一 个 新 方法 check _ bullet alien collisions()， 用 于 检测 子弹 和 外 星人 之 间 的 
碰撞 ,并 在 整 群 外 星人 被 消灭 干净 时 采取 相应 的 措施 。 这 能 避免 update_bullets() 过 长 , 简化 了 
后 续 开 发 工作 。 


动手 试 一 试 
练习 13-5: 侧面 射击 2 完成 练习 12-6 之 后 ， 我 们 给 游戏 《外 星人 入 侵 》 添 加 了 


很 多 功能 。 在 本 练习 中 ， 请 尝试 让 练习 12-6 中 飞船 的 功能 与 当前 《外 星人 入 侵 》 中 的 
类 似 。 在 屏幕 右 侧 添加 一 群 外 星人 (或 让 外 星人 的 位 置 随机 )， 并 让 其 向 飞船 移动 。 另 
外 ， 编 写 代 码 让 被 子弹 击 中 的 外 星人 消失 。 


13.6 ”结束 游戏 


如 果 玩 家 根本 不 会 输 , 游戏 还 有 什么 趣味 和 挑战 性 可 言 ? 如 果 玩 家 没 能 在 足够 短 的 时 间 内 将 
整 群 外 星人 消灭 干净 ,导致 有 外 星人 撞 到 了 飞船 或 抵达 屏幕 底 端 ， 飞 船 将 被 摧 器 。 与 此 同时 ， 限 
制 玩家 可 使 用 的 飞船 数 ， 在 玩家 用 光 所 有 的 飞船 后 ， 游 戏 将 结束 。 


13.6.1 检测 外 星人 和 飞船 碰撞 


首先 检查 外 星人 和 飞船 之 间 的 碰撞 ， 以 便 在 外 星人 撞 上 飞船 时 做 出 合适 的 响应 。 为 此 ,在 
AlienInvasion 中 更 新 每 个 外 星人 的 位 置 后 ， 立 即 检测 外 星人 和 飞船 之 间 的 碰撞 : 


alien_invasion.py def update aliens(self) 
-- SNip-- 


self.aliens.update() 


# 检测 外 星人 和 飞船 之 间 的 碰撞 。 
if pygame.sprite.spritecollideany(self.ship, self.aliens): 
print("Ship hit!!1") 


Q@ ee 


函数 spritecollideany() 接 受 两 个 实 参 : 一 个 精灵 和 一 个 编组 。 它 检查 编组 是 否 有 成 员 与 精 
灵 发 生 了 碰撞 ， 并 在 找到 与 精灵 发 生 碰 撞 的 成 员 后 停止 遍历 编组 。 在 这 里 ， 它 遍历 编组 aliens， 
并 返回 找到 的 第 一 个 与 飞船 发 生 碰撞 的 外 星人 。 


如 果 没 有 发 生 碰撞 ，spritecollideany() 将 返回 None， 因此 @ 处 的 if 代码 块 不 会 执行 。 如 果 
找到 了 与 飞船 发 生 碰撞 的 外 星人 , 它 就 返回 这 个 外 星人 , 因此 if 代码 块 将 执行 : 打印 “Ship hit!!!” 
( 见 @ )。 有 外 星人 撞 到 飞船 时 ,需要 执行 很 多 任务 : 删除 余下 的 外 星人 和 子弹 , 让 飞船 重新 居中 ， 
以 及 创建 一 群 新 的 外 星人 。 编写 完成 这 些 任务 的 代码 之 前 , 需要 确定 检测 外 星人 和 飞船 碰撞 的 方 
法 是 否 可 行 。 为 此 ， 最 简单 的 方式 就 是 调用 函数 print()。 
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试 这 项 功能 时 ， 请 将 alien drop_speed 设置 为 较 大 的 值 ， 如 50 或 100， 这样 外 星人 将 更 快 地 撞 


现在 如 果 运 行 这 个 游戏 ， 则 每 当 有 外 星人 撞 到 飞船 时 ， 终 端 窗口 都 将 显示 “Ship hit!!1”。 测 


到 飞船 。 
13.6.2 ”响应 外 星人 和 飞船 碰撞 


现在 需要 确定 当 外 星人 与 飞船 发 生 碰撞 时 该 做 些 什么 。 我 们 不 销毁 ship 实例 并 创建 新 的 ， 


而 是 通过 跟踪 游戏 的 统计 信息 来 记录 飞船 被 撞 了 多 少 次 跟踪 统计 信息 还 有 助 于 记分 )。 


下 面 来 编写 一 个 用 于 跟踪 游戏 统计 信息 的 新 类 GameStats ,并 将 其 保存 为 文件 game_stats.py: 


game _stats.py Class GameStats: 


"跟踪 游戏 的 统计 信息 。""" 


def _init (self, ai game): 

Wi 初始 化 统计 信息 。""" 
self.settings = ai game.settings 
self.reset stats() 


def reset stats(self): 
"" "初始化 在 游戏 运行 期 间 可 能 变化 的 统计 信 ， 
self.ships left = self.settings. 1 


在 游戏 运行 期 间 ， 只 创建 一 个 GameStats 实例 ,但 每 当 玩家 开始 新 游戏 时 ， 需 要 重 置 一 些 统 


计 信 息 。 为 此 ， 在 方法 reset_stats() 中 初始 化 大 部 分 统计 信息 ， 而 不 是 在 _init () 中 直接 初 
te 我 们 在 _init () 中 调用 这 个 方法 ， 这 样 创建 GameStats 实例 时 将 妥善 地 设置 这 些 统计 信 
息 ， 在 玩家 开始 新 游戏 时 也 能 调用 reset stats()。 


当前 ， 只 有 一 项 统计 信息 ships_left， 其 值 在 游戏 运行 期 间 不 断 变化 。 一 开始 玩家 拥有 的 飞 让 | 


船 数 存储 在 settings.py 的 ship_limit 中 : 


# 飞船 设置 
self.ship speed = 1.5 
self.ship limit = 3 


还 需 对 alien_invasion.py 做 些 修改 ， 以 创建 一 个 GameStats 实例 。 首 先 ， 更 新 这 个 文件 开头 


的 import 语句 : 


alien_invasion.py import sys 


from time import sleep 
import pygame 


from settings import Settings 
from game stats import GameStats 
from ship import Ship 

-- SNip-- 
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从 Python 标准 库 的 模块 time 中 导入 函数 sleep()， 以 便 在 飞船 被 外 星人 撞 到 后 让 游戏 暂停 
片刻 。 我 们 还 导入 了 GameStats。 


接 下 来 , 在 _init () 中 创建 一 个 GameStats 实例 : 


alien_invasion.py def init (self): 
-- SNip-- 
self.screen = pygame.display.set mode( 
(self.settings.screen width, self.settings.screen height)) 
pygame.display.set caption("Alien Invasion") 


# 创建 一 个 用 于 存储 游戏 统计 信息 的 实例 。 
self.stats = GameStats(self) 


self.ship = Ship(self) 
-- Snip-- 


在 创建 游戏 窗口 后 、 定 义 诸如 飞船 等 其 他 游戏 元 素 前 ， 创 建 一 个 GameStats 实例 。 

有 外 星人 挤 到 飞船 时 ， 将 余下 的 飞船 数 碱 1， 创建 一 群 新 的 外 星人 ， 并 将 飞船 重新 放 到 屏幕 
底 端 的 中 央 。 另 外 ,让 游戏 暂停 片刻 ,让 玩家 在 新 外 星人 群 出 现 前 注意 到 发 生 了 碰撞 并 将 重新 创 
建 外 星人 和 群 。 

下 面 将 实现 这 些 功能 的 大 部 分 代码 放 到 新 方法 ship_hit() 中 。 在 _update aliens() 中 , 将 在 
有 外 星人 挤 到 飞船 时 调用 这 个 方法 : 


alien_invasion.py def ship hit(self): 
"响应 飞船 被 外 星人 接 到 。""， 


# 将 ships left 减 1。 
© self.stats.ships left -= 1 


# 清空 余下 的 外 星人 和 子弹 。 
@ self.aliens.empty() 
self.bullets.empty() 


# 创建 一 群 新 的 外 星人 ， 并 将 飞船 放 到 屏幕 底 端的 中 央 。 
© self. create fleet() 
self.ship.center ship() 


# 暂停 。 
@ sleep(0.5) 


新 方法 ship_hit() 在 飞船 被 外 星人 撞 到 时 做 出 响应 。 在 这 个 方法 中 ， 将 余下 的 飞船 数 减 1 
( 见 @ )， 再 清空 编组 aliens 和 bullets ( 见 @ )。 

接 下 来 ,创建 一 群 新 的 外 星人 ,并 将 飞船 居中 ( 见 @ )。( 稍 后 将 在 Ship 类 中 添加 方法 center 
ship()。) 最 后 ， 在 更 新 所 有 元 素 后 (但 在 将 修改 显示 到 屏幕 前 ) 暂停 ， 让 玩家 知道 飞船 被 撞 到 


13.6 ”结束 游戏 247 


了 ( 见 @ ),。 这 里 的 函数 调用 sleep() 证 游戏 暂停 半 秒 钟 ， 让 玩家 能 够 看 到 外 星人 撞 到 了 飞船 。 画 
数 sleep() 执 行 完 毕 后， 将 接着 执行 方法 _update_screen() ， 将 新 的 外 星人 群 绘制 到 屏幕 上 。 


在 _update aliens() 中 ,， 当 有 外 星人 撞 到 飞船 时 , 不 调用 函数 print(), 而 调用 _ship_hit(): 


alien_invasion.py def update aliens(self): 
-- Snip-- 
if pygame.sprite.sprit 
self. ship hit() 


ecollideany(self.ship, self.aliens): 


下 面 是 新 方法 center_ship( 


) ， 请 将 其 添加 到 ship.py 的 末尾 : 


ship.py def center ship(self): 


"让 飞船 在 屏 莫 底 端 居中 。 


self.rect.midbottom = 


self.screen rect.midbottom 


self.x = float(self.rect.x) 


这 里 像 _init _() 中 那样 让 飞船 在 屏幕 底 端 居中 。 让 飞船 在 屏幕 底 端 居中 后 ， 重 置 用 于 跟踪 


飞船 确切 位 置 的 属性 self.x。 


注意 ”我 们 根本 没有 创建 多 艘 飞船 。 在 整个 游戏 运行 期 间 ， 只 创建 了 一 个 飞船 实例 ， 并 在 该 飞 
船 被 撞 到 时 将 其 居中 。 统 计 信 息 ships_left 指出 玩家 是 否 用 完了 所 有 的 飞船 。 


请 运行 这 个 游戏 ， 射 杀 几 个 外 星人 , 并 让 一 个 外 星人 撞 到 飞船 。 游 戏 暂停 片刻 后 ， 将 出 现 一 
群 新 的 外 星人 ， 而 飞船 将 在 屏幕 底 端 居中 。 


13.6.3 ”有 外 星人 到 达 屏 幕 底 端 


如 果 有 外 星人 到 达 屏 幕 底 端 ， 我 们 将 像 有 外 星人 撞 到 飞船 那样 做 出 响应 。 为 检测 这 种 情况 ， 
在 alien_invasion.py 中 添加 一 个 新 方法 : 


alien_invasion.py def check aliens bottom 
'" "检查 是 否 有 外 星人 到 


self): 
达 了 屏幕 底 阅 。""" 


screen rect = self.screen.get rect() 
for alien in self.aliens.sprites(): 


© if alien.rect.bo 


ttom >= screen rect.bottom: 


# 像 飞 船 被 撞 到 一 样 处 理 。 
self. ship hit() 


break 


方法 _check_aliens_bottom() 检 查 是 否 有 外 星人 到 达 了 屏幕 底 端 。 到 达 屏 幕 底 端 后 ， 外 星人 


的 属性 rect.bottom 大 于 或 等 于 屏幕 的 属性 rect.bottom ( 见 @ )。 如 果 有 外 星人 到 达 屏 幕 底 端 ， 


就 调用 _ship_hit()。 只 要 检测 到 一 个 外 星人 到 达 屏 幕 底 端 ， 就 无 须 检查 其 他 外 星人 了 ， 因 此 在 


调用 ship_hit() 后 退出 循环 。 
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我 们 在 _update_aliens() 中 调用 _check aliens bottom(): 


alien_invasion.py def update aliens(self) 
-- Snip-- 
# 检查 是 否 有 外 星人 撞 到 飞船 
if pygame.sprite.spritecollideany(self.ship, self.aliens): 
self. ship hit() 


# 检查 是 否 有 外 星人 到 达 了 屏幕 底 端 。 
self. check aliens bottom() 


在 更 新 所 有 外 星人 的 位 置 并 检测 是 否 有 外 星人 和 飞船 发 生 磁 撞 后 调用 _check_aliens_bottom()。 
现在 ， 每 当 有 外 星人 撞 到 飞船 或 抵达 屏幕 底 端 时 ， 都 将 出 现 一 群 新 的 外 星人 。 


13.6.4 ”游戏 结束 


现在 这 个 游戏 看 起 来 更 完整 了 ， 但 它 永远 都 不 会 结束 ， 只 是 ships_left 不 断 变 成 越 来 越 小 
的 负数 。 下 面 在 GameStats 中 添加 一 个 作为 标志 的 属性 game_active， 以 便 在 玩家 的 飞船 用 完 后 
结束 游戏 。 首 先 ， 在 GameStats 类 的 方法 _init () 末 尾 设置 这 个 标志 : 


出 


game_stats.py def init (self, ai game): 
-- SNip-- 
# 游戏 刚 启 动 时 处 于 活动 状态 。 
self.game active = True 


接 下 来 在 _ship_hit() 中 添加 代码 ， 在 玩家 的 飞船 用 完 后 将 game_active 设置 为 False: 


alien_invasion.py def ship hit(self): 

"" "响应 飞船 被 外 星人 撞 到 

if self.stats.ships left > 0: 
# 将 ships le 化 减 1 
self.stats.ships left -= 1 

-- Snip-- 

# 暂停 
sleep(0.5) 

else: 
self.stats.game active = False 


_ship_hit() 的 大 部 分 代码 没有 变 。 我 们 将 原来 的 代码 都 移 到 了 一 个 if 语句 块 中 ， 它 检查 玩 
家 是 否 至 少 还 有 一 艘 飞船 。 如 果 是 ,就 创建 一 群 新 的 外 星人 ， 和 暂停 片刻 ,再 接着 往 下 执行 。 如 果 
玩家 没有 了 飞船 ， 就 将 game_active 设置 为 False。 


13.7 ”确定 应 运行 游戏 的 哪些 部 分 


我 们 需要 确定 游戏 的 哪些 部 分 在 任何 情况 下 都 应 运行 ， 哪 些 部 分 仅 在 游戏 处 于 活动 状态 时 
才 运 行 : 
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alien_invasion.py def run game(self): 
"" "开始 游 戏 主 循环 。""" 
while True: 
self. check events() 


if self.stats.game active: 
self.ship.update() 
self. update bullets() 
self. update aliens() 


self. update screen() 


在 主 循环 中 ， 在 任何 情况 下 都 需要 调用 _check_events()， 即 便 游 戏 处 于 非 活 动 状 态 。 例 如 ， 
我 们 需要 知道 玩家 是 否 按 了 Q 键 以 退出 游戏 , 或 者 是 否 单 击 了 关闭 窗口 的 按钮 。 我 们 还 需要 不 
断 更 新 屏幕 ,以便 在 等 待 玩 家 是 否 选择 开始 新 游戏 时 修改 屏幕 。 其 他 的 函数 仅 在 游戏 处 于 活动 状 
态 时 才 需 要 调用 ， 因 为 游戏 处 于 非 活动 状态 时 ， 不 用 更 新 游戏 元 素 的 位 置 。 


现在 运行 这 个 游戏 ， 它 将 在 飞船 用 完 后 停止 不 动 。 


动手 试 一 斌 


练习 13-6: 游戏 结束 ”在 为 完成 练习 13-5 而 编写 的 游戏 中 ， 记 录 飞 船 被 撞 到 了 多 
少 次 以 及 有 多 少 外 星人 被 射 杀 。 确 定 合适 的 游戏 结束 条 件 ,并 在 满足 该 条 件 后 结束 游戏 。 


13.8 ”小结 


在 本 章 中 ， 你 学 习 了 : 如 何在 游戏 中 添加 大 量 相同 的 元 素 ， 如 创建 一 群 外 星人 ; 如 何 使 用 由 
套 循环 来 创建 元 素 网 格 , 还 通过 调用 每 个 元 素 的 方法 update() 移 动 了 大 量 元 素 ; 如 何 控制 对 象 在 
屏幕 上 移动 的 方向 ,以 及 如 何 响应 事件 ,如 有 外 星人 到 达 屏幕 边缘 ;如何 检测 和 响应 子弹 和 外 星 
人 碰撞 以 及 外 星人 和 飞船 磁 撞 ; 如 何在 游戏 中 跟踪 统计 信息 ， 以 及 如 何 使 用 标志 game_active 来 
判断 游戏 是 否 结束 。 

在 与 这 个 项 目 相关 的 最 后 一 章 中 ， 我 们 将 添加 一 个 Play 按钮 ， 让 玩家 能 够 开始 游戏 ， 以 及 
在 游戏 结束 后 重 玩 。 每 当 玩家 消灭 一 群 外 星人 后 我们 都 将 加 快 游戏 的 节奏 ， 并 添加 一 个 记分 系 
统 ， 得 到 一 个 极 具 可 玩 性 的 游戏 ! 


本 章 将 结束 游戏 《外 星人 入 侵 》 的 开发 。 我 们 会 添加 一 个 Play 
按钮 ， 用 于 根据 需要 启动 游戏 以 及 在 游戏 结束 后 重启 游戏 , 还 会 修改 
这 个 游戏 ， 使 其 随 玩家 等 级 提高 而 加 快 节奏 ， 并 实现 一 个 记分 系统 。 
阅读 本 章 后 ,你 将 掌握 足够 多 的 知识 , 能 够 开始 编写 随 玩家 等 级 提高 
而 加 大 难度 以 及 显示 得 分 的 游戏 。 


14.1 添加 Play 按钮 

本 节 将 添加 一 个 Play 按钮 ， 它 在 游戏 开始 前 出 现 ， 并 在 游戏 结束 后 再 次 出 现 ， 让 玩家 能 够 
开始 新 游戏 。 

当前 , 这 个 游戏 在 玩家 运行 alien_invasion.py 时 就 开始 了 。 下面 让 游戏 一 开始 处 于 非 活动 状态 ， 
并 提示 玩家 单 击 Play 按钮 来 开始 游戏 。 为 此 ， 像 下 面 这 样 修改 Gamestats 类 的 方法 _ init (): 


game_stats.py def init (self, ai game): 
in 初始 化 统计 信息 。""" 
self.settings = ai game.settings 
self.reset stats() 


# 让 游戏 一 开始 处 于 非 活动 状态 。 
self.game active = False 


现在 ， 游 戏 一 开始 将 处 于 非 活动 状态 ， 待 创建 Play 按钮 后 ， 玩 家 才能 开始 游戏 。 
14.1.1 创建 Button 类 


由 于 Pygame 没有 内 置 创建 按钮 的 方法 , 我 们 将 编写 一 个 Button 类 , 用 于 创建 带 标签 的 实心 
和 矩形。 你 可 在 游戏 中 使 用 这 些 代 码 来 创建 任何 按钮 。 下 面 是 Button 类 的 第 一 部 分 ， 请 将 这 个 类 
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保存 为 文件 button.py: 


buffon.py import pygame.font 
class Button : 


© def _init (self, ai game, msg): 
"" "初始化 按钮 的 属性 。""" 
self.screen = ai game.screen 
self.screen rect = self.screen.get rect() 


# 设置 按钮 的 尺寸 和 其 他 属性 。 

@ self.width, self.height = 200，50 
self.button color = (0, 255, 0) 
self.text color = (255, 255, 255) 

@ self.font = pygame.font.SysFont(None, 48) 


# 创建 按钮 的 Tect 对 象 ， 并 使 其 居中 。 
@ self.rect = pygame.Rect(0, 0, self.width, self.height) 
self.rect.center = self.screen rect.center 


> # 按钮 的 标签 只 需 创建 一 次 。 
© self. prep msg(msg) 


首先 ， 导 入 模块 pygame.font， 它 让 Pygame 能 够 将 文本 泻 染 到 屏幕 上 。 方法 init () 接 
受 参 数 self、 对 象 ai game 和 msg， 其 中 msg 是 要 在 按钮 中 显示 的 文本 ( 见 @ )。 设 置 按钮 的 尺 
寸 ( 见 @ ), 再 通过 设置 button_color， 让 按钮 的 rect 对 象 为 亮 绿 色 ， 并 通过 设置 text_color 让 
文本 为 白色 。 


在 @ 处 ， 指 定 使 用 什么 字体 来 演 染 文本 。 实 参 None 让 Pygame 使 用 默认 字体 ， 而 48 指定 了 
文本 的 字号 。 为 让 按钮 在 屏幕 上 居中 ， 创 建 一 个 表示 按钮 的 rect 对 象 ( 见 @ )， 并 将 其 center 
盟 性 设置 为 屏幕 的 center 属性 。 

Pygame 处 理 文本 的 方式 是 ， 将 要 显示 的 字符 串 泻 染 为 图 像 。 在 @ 处 ， 调 用 了 _prep_msg() 来 
处 理 这 样 的 泻 染 。 
_prep_msg() 的 代码 如 下 : 


bution.py def prep msg(self, msg): 
""" 将 msg 诊 当 为 图 像 ， 并 使 其 在 按钮 上 居中 。""" 
© self.msg image = self.font.render(msg, True, self.text color, 
self.button color) 
© self.msg image rect = self.msg image.get rect() 


self.msg image rect.center = self.rect.center 


方法 _prep_msg() 接 受 实 参 self 以 及 要 泻 染 为 图 像 的 文本 (msg )。 调 用 font.render() 将 存储 
在 msg 中 的 文本 转换 为 图 像 ， 再 将 该 图 像 存储 在 self.msg_image 中 ( 见 @ )。 方 法 font.render() 
还 接受 一 个 布尔 实 参 ， 该 实 参 指定 开启 还 是 关闭 反 饮 齿 功 能 ( 反 锯 齿 让 文本 的 边缘 更 平滑 )。 余 
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下 的 两 个 实 参 分 别 是 文本 颜色 和 背景 色 。 我 们 启用 了 反 锯齿 功能 , 并 将 文本 的 背景 色 设 置 为 按钮 
的 颜色 。( 如 果 没 有 指定 背景 色 ，Pygame 演 染 文本 时 将 使 用 透明 背景 。) 


在 @ 处 ， 让 文本 图 像 在 按钮 上 居中 : 根据 文本 图 像 创建 一 个 rect， 并 将 其 center 属性 设置 
为 按钮 的 cente 属性 。 


最 后 ， 创 建 方法 draw_button() ， 用 于 将 这 个 按钮 显示 到 屏幕 上 : 


button.py def draw button(self): 
# 绘制 一 个 用 颜色 填充 的 按钮 ， 再 绘制 文本 。 
self.screen.fill(self.button color, self.rect) 
self.screen.blit(self.msg image, self.msg image rect) 


我 们 调用 screen.fill() 来 绘制 表示 按钮 的 矩形 ， 再 调用 screen.blit() 并 向 它 传递 一 幅 图 像 
以 及 与 该 图 像 相 关联 的 rect， 从 而 在 屏幕 上 绘制 文本 图 像 。 至 此 ，Button 类 便 创 建 好 了 。 


14.1.2 ”在 屏幕 上 绘制 按钮 
我 们 将 在 AlienInvasion 中 使 用 Button 类 来 创建 一 个 Play 按钮。 首先， 更 新 import 语句 : 


alien_invasion.py  -- S11p-- 
from game stats import GameStats 
from button import Button 


只 需要 一 个 Play 按钮 ， 因 此 在 AlienInvasion 类 的 方法 _init _() 中 创建 它 。 可 将 这 些 代 码 
放 在 方法 _init () 的 末尾 : 


alien_invasion.py def init (self): 
-- SNip-- 
self. create fleet() 


# 创建 Play 按钮 。 
self.play button = Button(self, "Play") 


这 些 代 码 创 建 一 个 标签 为 Play 的 Button 实例 ， 但 没有 将 它 显 示 到 屏幕 上 。 为 显示 该 按钮 ， 
在 _update_screen() 对 其 调用 方法 draw_button(): 


alien_invasion.py def update screen(self): 
-- SNnip-- 
self.aliens.draw(self.screen) 
# 如 果 游 戏 处 于 非 活动 状态 ， 就 绘制 Play 按钮 。 
if not self.stats.game active: 


self.play_button.draw button() 


pygame.display.flip() 


14.1 添加 Play 按钮 253 


恒 幕 元 素 上 面 ， 在 绘制 其 他 所 有 游戏 元 素 后 再 绘制 这 个 按钮 ， 
寺 才 出 现 。 


为 让 Play 按钮 位 于 其 他 所 有 
然后 切换 到 新 屏幕 。 将 这 些 代码 放 在 一 个 if 代码 块 中 , 让 按钮 仅 在 游戏 出 于 非 活动 状态 


如 果 现 在 运行 这 个 游戏 ， 将 在 屏幕 中 央 看 到 一 个 Play 按钮 ， 如 图 14-1 所 示 。 


Alien Invasion 


图 


会 


图 14-1 游戏 处 于 非 活动 状态 时 出 现 的 Play 按钮 


14.1.3 ”开始 游戏 
为 在 玩家 单 击 Play 按钮 时 开始 新 游戏 ， 在 _check_events() 末 尾 添加 如 下 elif 代码 块 ， 以 监 


视 与 该 按钮 相关 的 鼠标 事件 : 


def check events(self): 
""" 响 应 按键 和 和 饼 标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
-- Snip-- 
elif event.type == pygame.MOUSEBUTTONDOWN: 
mouse pos = pygame.mouse.get pos() 
self. check play button(mouse pos) 


alien_invasion.py 


@Q@e 


无 论 玩 家 单 击 屏幕 的 什么 地 方 ，Pygame 都 将 检测 到 一 个 MOUSEBUTTONDOWN 事件 ( 见 @ )， 但 


我 们 只 想 让 这 个 游戏 在 玩家 用 鼠标 单 击 Play 按钮 时 做 出 响应 。 为 此 ， 使 用 了 pygame.mouse. 
get_pos()， 它 返回 一 个 元 组 ， 其 中 包含 玩家 单 击 时 鼠标 的 x 坐标 和 yy 坐标 ( 见 @ )。 我们 将 这 些 


值 传递 给 新 方法 _check_play_button() ( 见 @ )。 
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方法 _check_play_button() 的 代码 如 下 ， 将 它 放 在 _check_events() 后 面 : 


alien_invasion.py def check play button(self, mouse pos): 
mm 在 玩家 单 击 Play 按钮 时 开始 新 游戏 。""" 
© if self.play button.rect.collidepoint (mouse pos): 


self.stats.game active = True 


这 里 使 用 了 rect 的 方法 collidepoint() 检 查 鼠 标 单 击 位 置 是 否 在 Play 按 钮 的 rect 内 ( 见 @ )。 
如 果 是 ， 就 将 game_active 设置 为 True， 让 游戏 开始 ! 

至 此 ， 现 在 应 该 能 够 开始 这 个 游戏 了 。 游 戏 结束 时 ， 应 将 game_active 设置 为 False， 并 重 
新 显示 Play 按钮 。 


14.1.4” 重 置 游戏 


前 面 编写 的 代码 只 处 理 了 玩家 第 一 次 单 击 Play 按钮 的 情况 ， 而 没有 处 理 游 戏 结束 的 情况 ， 
因为 没有 重 置 导致 游戏 结束 的 条 件 。 

为 在 玩家 每 次 单 击 Play 按钮 时 都 重 置 游戏 ,需要 重 置 统计 信息 、 删 除 现 有 的 外 星人 和 子弹 、 
创建 一 群 新 的 外 星人 并 让 飞船 居中 ， 如 下 所 示 : 


alien_invasion.py def check play button(self, mouse pos): 
""" 在 玩家 单 击 Play 按钮 时 开始 新 游戏 。""" 
if self.play button.rect.collidepoint(mouse pos): 
# 重 置 游戏 统计 信息 。 
© self.stats.reset stats() 
self.stats.game active = True 


# 清空 余下 的 外 星人 和 子弹 。 
@ self.aliens.empty() 
self.bullets.empty() 


# 创建 一 群 新 的 外 星人 并 让 飞船 居中 。 
© self. create fleet() 
self.ship.center ship() 


在 @ 处 , 重 置 游 戏 统计 信息 , 给 玩家 提供 三 艘 新 飞船 。 接 下 来 , 将 game_active 设置 为 True。 
这 样 ， 这 个 方法 的 代码 执行 完毕 后 ， 游 戏 就 将 开始 。 清 空 编组 aliens 和 bullets ( 见 @ )， 然 后 
创建 一 群 新 的 外 星人 并 将 飞船 居中 ( 见 @ )。 


现在 ,每 当 玩 家 单 击 Play 按钮 时 ,这 个 游戏 都 将 正确 地 重 置 ， 让 玩家 想 玩 多 少 次 就 玩 多 少 次 ! 


14.1.5 将 Play 按钮 切换 到 非 活 动 状态 


当前 存在 一 个 问题 : 即便 Play 按钮 不 可 见 ， 玩 家 单 击 其 所 在 的 区 域 时 ， 游 戏 依然 会 做 出 响 
应 。 游 戏 开 始 后 ， 如 果 玩 家 不 小 心 单 击 了 Play 按钮 所 处 的 区 域 ， 游 戏 将 重新 开始 ! 
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为 修复 这 个 问题 ， 可 让 游戏 仅 在 game_active 为 False 时 才 开始 : 


alien_invasion.py def check play button(self, mouse pos) 
""" 玩 家 单 击 Play 按钮 时 开始 新 游戏 。""" 
© button clicked = self.play button.rect.collidepoint (mouse pos) 
© if button clicked and not self.stats.game active: 


# 重 置 游戏 统计 信息 。 
self.stats.reset stats() 
-- Snip-- 


标志 button_clicked 的 值 为 True 或 False ( 见 @ ), 仅 当 玩家 单 击 了 Play 按钮 且 游 戏 当 前 
处 于 非 活动 状态 时 ， 游 戏 才 重新 开始 ( 见 @ )。 要 测试 这 种 行为 ， 可 开始 新 游戏 ， 并 不 断 单 击 
Play 按钮 所 在 的 区 域 。 如 果 一 切 都 像 预期 的 那样 工作 , 单 击 Play 按钮 所 处 的 区 域 应 该 没有 任何 
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14.1.6 ”隐藏 鼠标 光标 


为 让 玩家 能 够 开始 游戏 ,要 让 鼠标 光标 可 见 ， 但 游戏 开始 后 ， 光 标 只 会 添乱 。 为 修复 这 种 问 
题 , 需要 在 游戏 处 于 活动 状态 时 让 光标 不 可 见 。 可 在 方法 _check_play_button() 末 尾 的 if 代码 块 


中 完成 这 项 任务 : 
alien_invasion.py def check play button(self, mouse pos) 


""" 在 玩家 单 击 Play 按钮 时 开始 新 游戏 。""" 
button clicked = self.play button.rect.collidepoint(mouse pos) 
if button clicked and not self.stats.game active: 

-- SNip-- 

# 隐藏 筷 标 光标 。 


pygame.mouse.set visible(False) 


通过 向 set _ visible() 传 递 False， 让 Pygame 在 光标 位 于 游戏 窗口 内 时 将 其 隐藏 起 来 。 


游戏 结束 后 ， 将 重新 显示 光标 ， 让 玩家 能 够 单 击 Play 按钮 来 开始 新 游戏 。 相 关 的 代码 4 
如 下 : 


alien_invasion.py def ship hit(self): 
"响应 飞船 被 外 星人 樟 到 。""" 
if self.stats.ships left > 0: 
--Snip-- 
else: 
self.stats.game active = False 
pygame.mouse.set visible(True) 


在 _ship_hit() 中 ， 在 游戏 进入 非 活动 状态 后 ， 立 即 让 光标 可 见 。 关 注 这 样 的 细节 让 游戏 显 
得 更 专业 ， 也 让 玩家 能 够 专注 于 玩 游戏 而 不 是 去 费力 理解 用 户 界面 。 


动手 试 一 试 
练习 14-1: 按 卫 键 开始 新 游戏 ”鉴于 游戏 《外 星人 入 侵 》 使 用 键盘 来 控制 飞船 ， 
最 好 也 能 够 让 玩家 通过 按键 来 开始 游戏 。 请 添加 在 玩家 按 P 键 时 开始 游戏 的 代码 。 也 
许 这 样 做 会 有 所 帮助 : 将 _check play button() 的 一 些 代码 提取 出 来 ， 放 到 一 个 名 为 
_start game() 的 方法 中 ， 并 在 _check play button() 和 check keydown events() 中 调 


用 这 个 方法 。 

练习 14-2: 射击 练习 “创建 一 个 和 矩形 ， 让 它 在 屏幕 右边 缘 以 国定 的 速度 上 下 移动 。 
然后 ， 在 屏幕 左边 缘 创 建 一 稻 飞 船 ， 玩 家 可 上 下 移动 它 来 射击 前 述 和 珑 形 标 靶 。 添 加 一 个 
用 于 开始 游戏 的 Play 按钮 ， 在 玩家 三 次 未 击 中 目标 时 结束 游戏 ， 并 重新 显示 Play 按钮 ， 
让 玩家 能 够 单 击 该 按钮 来 重新 开始 游戏 。 


14.2 ”提高 等 级 


当前 , 将 整 群 外 星人 消灭 干净 后 ,玩家 将 提高 一 个 等 级 ,但 游戏 的 难度 没 变 。 下 面 来 增加 一 
点 趣味 性 : 每 当 玩 家 将 屏幕 上 的 外 星人 消灭 干净 后 ， 都 加 快 游戏 的 节奏 ， 让 游戏 玩 起 来 更 难 。 


14.2.1 修改 速度 设置 


首先 重新 组 织 Settings 类 ， 将 游戏 设置 划分 成 静态 和 动态 两 组 。 对 于 随 着 游戏 进行 而 变化 
的 设置 ， 还 要 确保 在 开始 新 游戏 时 进行 重 置 。settings.py 的 方法 _init () 如 下 : 


settings.py def init (self): 
""" 初 始 化 游戏 的 静态 设置 。""" 
# 屏 幕 设 置 
self.screen width = 1200 
self.screen height = 800 
self.bg color = (230，230，230) 
# 飞船 设置 


self.ship limit = 3 


# 子弹 设置 

self.bullet width = 3 
self.bullet height = 15 
self.bullet color = 60，60，60 
self.bullets allowed = 3 


# 外 星人 设置 


self.fleet drop speed = 10 
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# 加 快 游戏 节奏 的 速度 。 
© self.speedup scale = 1.1 


© self.initialize dynamic settings() 


依然 在 _init () 中 初始 化 静态 设置 。 在 @ 处 , 添加 设置 speedup_scale, 用 于 控制 游戏 节奏 
的 加 快速 度 : 2 表示 玩家 每 提高 一 个 等 级 ,游戏 的 节奏 就 翻 一 倍 ; 1 表示 游戏 节奏 始终 不 变 。 将 
其 设置 为 1.1 能 够 将 游戏 节奏 提高 到 足够 快 ， 让 游戏 既 有 难度 又 并 非 不 可 完成 。 最 后 ， 调 用 
initialize dynamic_settings() 初 始 化 随 游 戏 进 行 而 变化 的 属性 〈 见 @ )。 


initialize dynamic_settings() 的 代码 如 下 : 


settings.py def initialize dynamic settings(self): 

""" 初 始 化 随 游戏 进行 而 变化 的 设置 。""" 
self.ship speed = 1.5 

self.bullet speed = 

self.alien speed = 1.0 


# fleet direction 为 1 表示 向 右 ， 为 -1 表示 向 左 
self.fleet direction = 1 


这 个 方法 设置 飞船 、 子 弹 和 外 星人 的 初始 速度 。 随 着 游戏 的 进行 ,将 提高 这 些 速度 。 每 当 玩 
家 开始 新 游戏 时 ， 都 将 重 置 这 些 速度 。 在 这 个 方法 中 ， 还 设置 了 Se 使 得 游戏 刚 
开始 时 , 外 星人 总 是 向 右 移动 。 不 需要 增 大 fleet_ drop_speed 的 值 , 因为 外 星人 移动 的 速度 越 快 ， 
到 达 屏 幕 底 端 所 需 的 时 间 越 短 。 


为 在 玩家 的 等 级 提高 时 提高 飞船 、 子 弹 和 外 星人 的 速度 ,编写 一 个 名 为 increase_speed() 的 
新 方法 : 


settings.py def increase speed(self): 


mun 提高 速度 设置 """ 
self.ship speed *= self.speedup scale 


self.bullet speed *= self.speedup scale 
self.alien speed *= self.speedup scale 


为 提高 这 些 游戏 元 素 的 速度 ， 将 每 个 速度 设置 都 乘 以 speedup_scale 的 值 。 
在 _ check bullet alien collisions() 中 ,在 整 群 外 星人 都 被 消灭 后 调用 increase speed() 


来 加 快 游戏 的 节奏 
alien_invasion.py def check bullet alien collisions(self): 
-- Snip-- 


if not self.aliens: 
# 删除 现 有 的 子弹 并 创 
self.bullets.empty() 
self. create fleet() 
self.settings.increase speed() 


建 一 群 新 的 外 星人 。 


通过 修改 速度 设置 ship speed、alien speed 和 bullet speed 的 值 ， 足 以 加 快 整个 游戏 的 
节奏 ! 
14.2.2 ” 重 置 速度 


每 当 玩家 开始 新 游戏 时 ， 都 需要 将 发 生 了 变化 的 设置 重 置 为 初始 值 ， 否 则 新 游戏 开始 时 , 速 
度 设置 将 为 前 一 次 提高 后 的 值 : 


alien_invasion.py def check play button(self, mouse pos ) : 
""" 在 玩家 单 击 Play 按钮 时 开始 新 游戏 。""" 
button clicked = self.play button.rect.collidepoint(mouse pos) 
if button clicked and not self.stats.game active: 
# 重 置 游戏 设置 。 
self.settings.initialize dynamic settings() 
-- Snip-- 


现在 ,游戏 《外 星人 入 侵 》 玩 起 来 更 有 趣 ， 也 更 有 挑战 性 了 。 每 当 玩家 将 屏幕 上 的 外 星人 
消灭 干净 后 ,游戏 都 将 加 快 节奏 ， 因 此 难度 更 大 。 如 果 游 戏 的 难度 提高 得 太 快 ， 可 降低 
settings.speedup_scale 的 值 ; 如 果 游 戏 的 挑战 性 不 足 ， 可 稍微 提高 这 个 设置 的 值 。 找 出 这 个 设 
置 的 最 佳 值 ,让 难度 的 提高 速度 相对 合理 : 一 开始 的 几 群 外 星人 很 容易 消灭 干净 , 接 下 来 的 几 群 
消灭 起 来 有 一 定 难 度 ， 但 也 不 是 不 可 能 ， 而 要 将 之 后 的 外 星人 群 消灭 干净 几乎 不 可 能 。 


动手 试 一 试 
练习 14-3: 有 一 定 难度 的 射击 练习 以 你 为 完成 练习 14-2 而 做 的 工作 为 基础 ， 让 


标 鞠 的 移动 速度 随 游戏 进行 而 加 快 ， 并 在 玩家 单 击 Play 按钮 时 将 其 重 置 为 初始 值 。 
练习 14-4: 难度 等 级 在 游戏 《外 星人 入 侵 》 中 创建 一 组 按钮 ， 让 玩家 选择 起 始 难 
度 等 级 。 每 个 按钮 都 给 Settings 中 的 属性 指定 合适 的 值 ， 以 实现 相应 的 难度 等 级 。 


14.3 ”记分 


下 面 来 实现 一 个 记分 系统 , 以 实时 跟踪 玩家 的 得 分 , 并 显示 最 高 得 分 、 等 级 和 余下 的 飞船 数 。 
得 分 是 游戏 的 一 项 统计 信息 ， 因 此 在 GameStats 中 添加 一 个 score 属性 : 


game stats.py Class GameStats: 
-- SNip-- 
def reset stats(self): 
"" "初始化 随 游 戏 进行 可 能 变化 的 统计 信息 。""" 
self.ships left = self.settings.ship limit 
self.score = 0 
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为 在 每 次 开始 游戏 时 都 重 置 得 分 ， 我 们 在 reset_stats() 而 不 是 _init () 中 初始 化 score。 


14.3.1 显示 得 分 

为 在 屏幕 上 显示 得 分 ， 首 先 创建 一 个 新 类 Scoreboard。 当 前 ， 这 个 类 只 显示 当前 得 分 ， 但 
后 面 也 将 使 用 它 来 显示 最 高 得 分 、 等 级 和 余下 的 飞船 数 。 下 面 是 这 个 类 的 前 半 部 分 ， 被 保存 为 
文件 scoreboard.py: 


scoreboard.py import pygame.font 


class Scoreboard: 
""" 显 示 得 分 信息 的 类 。""" 


© def _init (self, ai game): 
"" "初始 化 显示 得 分 涉及 的 属性 。""" 
self.screen = ai game.screen 
self.screen rect = self.screen.get rect() 
self.settings = ai game.settings 
self.stats = ai game.stats 


# 显示 得 分 信息 时 使 用 的 字体 设置 。 


© self.text color = (30, 30, 30) 

@ self.font = pygame.font.SysFont(None, 48) 
# 准备 初始 得 分 图 像 。 

@ self.prep_score() 


由 于 Scoreboard 在 屏幕 上 显示 文本 ， 首 先导 入 模块 pygame.font。 接 下 来 , 在 _init_() 中 
包含 形 参 ai_game, 以 便 访问 报告 跟踪 的 值 所 需 的 对 象 settings、screen 和 stats ( 见 @ )。 然 后 ， 
设置 文本 颜色 ( 见 @ ) 并 实例 化 一 个 字体 对 象 ( 见 @ )。 


为 将 要 显示 的 文本 转换 为 图 像 ， 调 用 prep_score() ( 见 @ )， 其 定义 如 下 : 


scoreboard.py def prep score(self): 
""" 将 得 分 转换 为 一 幅 演 染 的 图 像 。""" 
@ score str = str(self.stats.score) 
© self.score image = self.font.render(score str, True, 


self.text color, self.settings.bg color) 


# 在 屏幕 右上 角 显 示 得 分 。 

self.score rect = self.score image.get rect() 
self.score rect.right = self.screen rect.right - 20 
self.score rect.top = 20 


OO 


在 prep_score() 中 , 将 数值 stats.score 转换 为 字符 串 ( 见 @ ), 再 将 这 个 字符 串 传递 给 创建 
图 像 的 render() ( 见 @ )。 为 在 屏幕 上 清晰 地 显示 得 分 , 向 render() 传 递 屏 幕 背 景色 和 文本 颜色 。 
将 得 分 放 在 屏幕 右上 角 ，, 并 在 得 分 增 大 导致 数 变 宽 时 让 其 向 左 延伸 。 为 确保 得 分 始终 销 定 在 
屏幕 右边 , 创建 一 个 名 为 score rect 的 rect ( 见 @ ), 让 其 右边 缘 与 屏幕 右边 缘 相 距 20 像素 ( 见 @ )， 
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并 让 其 上 边缘 与 屏幕 上 边缘 也 相距 20 像素 ( 见 @ )。 
接 下 来 ， 创 建 方法 show_score() ， 用 于 显示 泻 染 好 的 得 分 图 像 


scoreboard.py 


def 


show score(self): 
"mr 在 屏幕 上 显示 得 分 。""" 
self.screen.blit(self.score image, self.score rect) 


这 个 方法 在 屏幕 上 显示 得 分 图 像 ， 并 将 其 放 在 score_rect 指定 的 位 置 。 


14.3.2 ”创建 记分 牌 


alien_invasion.py 


alien_invasion.py 


alien_invasion.py 


为 显示 得 分 ,在 AlienInvasion 中 创建 一 个 Scoreboard 实例 。 先 来 更 新 import 语句 : 


--Snip-- 


from game stats import GameStats 
from scoreboard import Scoreboard 


-- Snip-- 


接 下 来 ， 在 方法 ”init () 中 创建 一 个 Scoreboard 实例 : 


def 


_ init (self): 


-- SNnip-- 
pygame.display.set caption("Alien Invasion") 


# 创建 存储 游戏 统计 信息 的 实例 ， 
# ”并 创建 记分 牌 。 

self.stats = GameStats(self) 
self.sb = Scoreboard(self) 

-- Snip-- 


然后 ， 在 _update_screen() 中 将 记分 牌 绘制 到 屏幕 上 : 


def 


_update screen(self): 


-- SNnip-- 
self.aliens.draw(self.screen) 


# 显示 得 分 。 
self.sb.show score() 


# 如 果 游 戏 处 于 非 活动 状态 ， 就 显示 Play 按钮 。 
-- Snip-- 


在 显示 Play 按钮 前 调用 show score()。 


如 果 现 在 运行 这 个 游戏 ， 将 在 屏幕 右上 角 看 到 0。( 当前 ， 我 们 只 想 在 进一步 开发 记分 系统 


前 确认 得 分 出 现在 正确 的 地 方 。) 图 14-2 显示 了 游戏 开始 前 的 得 分 。 
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®@ Alien Invasion 


会 


图 14-2 得 分 出 现在 屏幕 右上 角 
下 面 来 指定 每 个 外 星人 值 多 少 分 ! 


14.3.3 ”在 外 星人 被 消灭 时 更 新 得 分 


为 在 屏幕 上 实时 显示 得 分 ， 每 当 有 外 星人 被 击 中 时 ， 都 更 新 stats.score 的 值 ， 再 调用 
prep_score() 更 新 得 分 图 像 。 但 在 此 之 前 ， 需 要 指定 玩家 每 击落 一 个 外 星人 将 得 到 多 少 分 : 


settings.py def initialize dynamic settings(self): 
-- Snip-- 


# 记分 
self.alien points = 50 


随 着 游戏 的 进行 ， 将 提高 每 个 外 星人 的 分 数 。 为 确保 每 次 开始 新 游戏 时 这 个 值 都 会 被 重 置 ， 
我 们 在 initialize dynamic_settings() 中 设置 它 。 


在 _ check _ bullet alien collisions() 中 ,每 当 有 外 星人 被 击落 时 ， 都 更 新 得 分 : 


alien_invasion.py def check _ bullet alien collisions(self): 
""" 响 应 子弹 和 外 星人 发 生 碰 挤 
# 删除 彼此 碰撞 的 子弹 和 外 星人 。 
collisions = pygame.sprite.groupcollide( 
self.bullets, self.aliens, True, True) 


if collisions: 
@ self.stats.score += self.settings.alien points 
self.sb.prep score() 
--Snip-- 


有 子弹 击 中 外 星人 时 ，Pygame 返回 一 个 字典 ( collisions )。 我 们 检查 这 个 字典 是 否 存在 ， 
如 果 存 在 ， 就 将 得 分 加 上 一 个 外 星人 的 分 数 ( 见 @ )。 接 下 来 ， 调 用 prep_score() 来 创建 一 幅 包 
含 最 新 得 分 的 新 图 像 。 


如 果 现 在 运行 这 个 游戏 ， 得 分 将 不 断 增加 ! 


14.3.4 重 置 得 


当前 , 仅 在 有 外 星人 被 射 杀 之 后 生成 得 分 。 这 在 大 多 数 情况 下 可 行 , 但 从 开始 新 游戏 到 有 外 
星人 被 射 杀 之 间 ， 显 示 的 是 上 一 次 的 得 分 。 


为 修复 这 个 问题 ， 可 在 开始 新 游戏 时 生成 得 分 : 


alien_invasion.py def check play button(self, mouse pos ) : 
-- SNnip-- 
if button clicked and not self.stats.game active: 
-- Snip-- 


# 重 置 游戏 统计 信息 。 
self.stats.reset stats() 
self.stats.game active = True 
self.sb.prep score() 

=-- Snip-- 


开始 新 游戏 时 ,我 们 重 置 游戏 统计 信息 再 调用 prep_score()。 此 时 生成 的 记分 牌 上 显示 的 得 
分 为 零 。 


14.3.5 将 消灭 的 每 个 外 星人 都 计 入 得 分 

当前 的 代码 可 能 会 遗漏 一 些 被 消灭 的 外 星人 。 例 如 ,如果 在 一 次 循环 中 ， 有 两 颗 子 弹 击 中 了 
外 星人 , 或 者 因子 弹 较 宽 而 同时 击 中 了 多 个 外 星人 , 玩家 将 只 能 得 到 一 个 外 星人 的 分 数 。 为 修复 
这 种 问题 ， 我 们 来 调整 检测 子弹 和 外 星人 碰撞 的 方式 。 

在 _ check bullet alien_collisions() 中 ， 与 外 星人 碰撞 的 子弹 都 是 字典 collisions 中 的 一 个 
键 ， 而 与 每 颗 子 弹 相 关 的 值 都 是 一 个 列表 ， 其 中 包含 该 子弹 击 中 的 外 星人 。 我 们 遍历 字典 
collisions， 确 保 将 消灭 的 每 个 外 星人 都 计 和 人 得 分 : 


alien_invasion.py def check bullet alien collisions(self): 
-- SNip-- 
if collisions: 
for aliens in collisions.values(): 
self.stats.score += self.settings.alien points * len(aliens) 
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self.sb.prep score() 
-- Snip-- 


如 果 字 典 collisions 存在 ， 就 遍历 其 中 的 所 有 值 。 别 忘 了 ， 每 个 值 都 是 一 个 列表 ， 包 含 被 
同一 颗 子 弹 击 中 的 所 有 外 星人 。 对 于 每 个 列表 , 都 将 其 包含 的 外 星人 数量 乘 以 一 个 外 星人 的 分 数 ， 
并 将 结果 加 入 当前 得 分 。 为 测试 这 一 点 , 请 将 子弹 宽度 改 为 300 像素 ,并 核实 得 到 了 其 击 中 的 每 
个 外 星人 的 分 数 ， 再 将 子弹 宽度 恢复 正常 值 。 


14.3.6 ”提高 分 数 


鉴于 玩家 每 提高 一 个 等 级 , 游戏 都 变 得 更 难 , 因此 处 于 较 高 的 等 级 时 , 外 星人 的 分 数 应 更 高 。 
为 实现 这 种 功能 ， 需 要 编写 在 游戏 节奏 加 快 时 提高 分 数 的 代码 : 


settings.py Class Settings: 
""" 和 存储 游戏 《外 星人 入 侵 》 的 所 有 设置 的 类 


def init (self): 
-- Snip-- 
# 加 快 游戏 节奏 的 速度 
self.speedup scale = 1.1 
# 外 星人 分 数 的 提高 速度 。 
@ self.score scale = 1.5 


self.initialize dynamic settings() 


def initialize dynamic settings(self): 
--SNip-- 


def increase speed(self): 
""" 提 高 速度 设置 和 外 星人 分 数 。""" 
self.ship speed *= self.speedup scale 
self.bullet speed *= self.speedup scale 
self.alien speed *= self.speedup scale 


四 self.alien points = int(self.alien points * self.score scale) 


我 们 定义 了 分 数 的 提高 速度 ， 并 称 之 为 score_scale ( 见 @ )。 较 低 的 节奏 加 快速 度 ( 1.1 ) 让 游戏 
很 快 变 得 极 具 挑战 性 ,但 为 了 让 记分 发 生 显著 的 变化 ,需要 将 分 数 的 提高 速度 设置 为 更 大 的 值 ( 1.5 )。 
现在 , 在 加 快 游戏 节奏 的 同时 , 提高 了 每 个 外 星人 的 分 数 ( 见 @ ) 为 让 分 数 为 整数 , 使 用 了 函数 int()。 


为 显示 外 星人 的 分 数 ， 在 Settings 的 方法 increase_speed() 中 调用 函数 print(): 


settings.py def increase speed(self): 
--SNnip-- 
self.alien points = int(self.alien points * self.score scale) 
print(self.alien points) 


现在 每 当 提高 一 个 等 级 时 ， 你 都 将 在 终端 窗口 看 到 新 的 分 数值 。 


注意 ”确认 分 数 在 不 断 增加 后 , 一定 和 要 删除 调用 函数 print() 的 代码 , 否则 可 能 影响 游戏 的 性 能 ， 
分 散 玩家 的 注意 力 。 


14.3.7” 舍 入 得 分 


大 多 数 街机 风格 的 射击 游戏 将 得 分 显示 为 10 的 整数 倍 ， 下 面 让 记分 系统 遵循 这 个 原则 。 我 们 
还 将 设置 得 分 的 格式 ， 在 大 数 中 添加 用 逗号 表示 的 干 位 分 隔 符 。 在 Scorepoard 中 执行 这 种 修改 : 


scoreboard.py def prep score(self): 
""" 将 得 分 转换 为 泻 数 的 图 像 。""" 
© rounded score = round(self.stats.score, -1) 
@ score str = "{:,}".format(rounded score) 


self.score image = self.font.render(score str, True, 
self.text color, self.settings.bg color) 
-- Snip-- 


函数 round() 通 常 让 小 数 精确 到 小 数 点 后 某 一 位 , 其 中 小 数位 数 是 由 第 二 个 实 参 指定 的 。 然而， 
如 果 将 第 二 个 实 参 指定 为 负数 ，round() 将 伟人 到 最 近 的 10 的 整数 倍 ， 如 10、100、1000 等 。@ 处 
的 代码 让 Python 将 stats.score 的 值 伟 人 到 最 近 的 10 的 整数 倍 , 并 将 结果 存储 到 rounded_score 中 。 

在 @ 处 ， 使 用 一 个 字符 串 格式 设置 指令 ， 让 Python 将 数值 转换 为 字符 串 时 在 其 中 搬 人 逗号 。 
例如 , 输出 为 1,000,000 而 不 是 1000000。 如 果 现 在 运行 这 个 游戏 , 看 到 的 得 分 将 是 10 的 整数 倍 ， 
即便 得 分 很 高 亦 如 此 ， 如 图 14-3 所 示 。 


© Alien Invasion 


3,589,080 


V4 


图 14-3 ”得 分 为 10 的 整数 倍 ， 并 将 逗号 用 作 王 分 位 分 隔 符 
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14.3.8 ”最 高 得 分 


每 个 玩家 都 想 超过 游戏 的 最 高 得 分 纪录 。 下面 来 跟踪 并 显示 最 高 得 分 , 给 玩家 提供 要 超越 的 
目标 。 我 们 将 最 高 得 分 存储 在 GameStats 中 : 


game_stats.py def init (self, ai game): 
-- Snip-- 
# 任何 情况 下 都 不 应 重 置 最 高 得 分 。 
self.high score = 0 


因为 在 任何 情况 下 都 不 会 重 置 最 高 得 分 ， 所 以 在 ”init () 而 不 是 reset_stats() 中 初始 化 


high score。 


下 面 来 修改 Scoreboard 以 显示 最 高 得 分 。 先 来 修改 方法 _ init _(): 


scoreboard.py def init (self, ai game): 
0 
# 准备 包含 最 高 得 分 和 当前 得 分 的 图 像 。 
self.prep_score() 
@ self.prep_high_score() 


最 高 得 分 将 与 当前 得 分 分 开 显 示 ， 因 此 需要 编写 一 个 新 方法 prep_high_score()， 用 于 准备 
包含 最 高 得 分 的 图 像 ( 见 @ )。 


方法 prep_high_score() 的 代码 如 下 : 


scoreboard.py def prep high score(self): 
""" 将 最 高 得 分 转换 为 演 染 的 图 像 。""" 
© high_score = round(self.stats.high score, -1) 
high score str = "{:,}".format(high score) 
© self.high score image = self.font.render(high score str, True, 


self.text color, self.settings.bg color) 


self. et high score image.get rect() 
3 self.high score rect.centerx = self.screen rect.centerx 
@ self.high score rect.top = self.score rect.top 


将 最 高 得 分 舍 入 到 最 近 的 10 的 整数 倍 ， 并 添加 用 逗号 表示 的 二分 位 分 隔 符 〈 见 @ )。 然 后 ， 
根据 最 高 得 分 生成 一 幅 图 像 ( 见 @ ), 使 其 水 平 居中 ( 见 @ )， 并 将 其 top 属性 设置 为 当前 得 分 图 
像 的 top 属 性 ( 见 @ )。 


现在 ,方法 show_score() 需 要 在 屏幕 右上 角 显 示 当 前 得 分 ， 并 在 屏幕 项 部 中 央 显 示 最 高 得 分 : 


scoreboard.py def show score(self): 
"" 在 屏幕 上 显示 得 分 。"" 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 
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为 检查 是 否 诞生 了 新 的 最 高 得 分 ， 在 Scoreboard 中 添加 一 个 新 方法 check_high_ score(): 


scoreboard.py def check high score(self): 
"" "检查 是 否 谴 生 了 新 的 最 高 得 分 。""" 
if self.stats.score > self.stats.high score: 
self.stats.high score = self.stats.score 
self.prep high score() 


方法 check_high_score() 比 较 当 前 得 分 和 最 高 得 分 。 如 果 当 前 得 分 更 高 ， 就 更 新 high_score 
的 值 ， 并 调用 prep_high_score() 来 更 新 包含 最 高 得 分 的 图 像 。 

在 _ check _ bullet alien collisions() 中 ， 每 当 有 外 星人 被 消灭 时 ， 都 需要 在 更 新 得 分 后 调 
用 check high score(): 


alien_invasion.py def check bullet alien collisions(self): 

-- Snip-- 

if collisions: 
for aliens in collisions.values(): 

self.stats.score += self.settings.alien points * len(aliens) 

self.sb.prep score() 
self.sb.check high score() 

-- Snip-- 


如 果 字 典 collisions 存在 ,就 根据 消灭 了 多 少 外 星人 更 新 得 分 ,再 调用 check_high_score()。 
第 一 次 玩 这 个 游戏 时 ， 当 前 得 分 就 是 最 高 得 分 ,因此 两 个 地 方 显示 的 都 是 当前 得 分 。 但 再 次 
开始 该 游戏 时 ， 最 高 得 分 会 出 现在 中 央 ， 而 当前 得 分 则 出 现在 右边 ， 如 图 14-4 所 示 。 
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图 14-4 ”最 高 得 分 显示 在 屏幕 顶部 中 央 
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14.3.9 ”显示 等 级 


为 在 游戏 中 显示 玩家 的 等 级 ,首先 需要 在 GameStats 中 添加 一 个 表示 当前 等 级 的 
保 每 次 开始 新 游戏 时 都 重 置 等 级 ， 在 reset_stats() 中 初始 化 它 : 


属性 。 为 确 


game_stats.py def reset stats(self): 
"" "初始化 随 游戏 进行 可 能 变化 的 统计 信息 。"" 
self.ships left = self.settings.ship limit 
self.score = 0 
self.level = 1 


为 了 让 Scoreboard 显示 当前 等 级 ,在 init () 中 调用 一 个 新 方法 prep_level(): 


scoreboard.py def init (self, ai game): 
-- SN1p-- 
self.prep high score() 
self.prep level() 


prep_level() 的 代码 如 下 : 


scoreboard.py def prep level(self): 
wun 将 等 级 转换 为 泻 染 的 图 像 。""" 
level str = str(self.stats.level) 
© self.level image = self.font.render(level str, True, 


self.text color, self.settings.bg color) 


# 将 等 级 放 在 得 分 下 方 。 
self.level rect = self.level image.get rect() 
@ self.level rect.right = self.score rect.right 
3 self.level rect.top = self.score rect.bottom + 10 


方法 prep_level() 根 据 存储 在 stats.level 中 的 值 创 建 一 幅 图 像 ( 见 @ ), 并 将 其 right 属性 
设置 为 得 分 的 right 属性 ( 见 @ ), 然后, 将 top 属性 设置 为 比 得 分 图 像 的 bottom 属性 大 10 像素， 


以 便 在 得 分 和 等 级 之 间 留 出 一 定 的 空间 ( 见 @ )。 
还 需要 更 新 show_score(): 


scoreboard.py def show score(self): 
""" 在 屏幕 上 显示 得 分 和 等 级 。""" 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 
self.screen.blit(self.level image, self.level rect) 


新 增 的 代码 行 在 屏幕 上 显示 等 级 图 像 。 
我 们 在 check bullet alien collisions() 中 提高 等 级 并 更 新 等 级 图 像 : 


alien_invasion.py def check bullet alien collisions(self) : 
-- SNip-- 
if not self.aliens: 
# 删除 现 有 的 子弹 并 新 建 一 群 外 星人 。 
self.bullets.empty() 
self. create fleet() 
self.settings.increase speed() 


# 提高 等 级 。 
self.stats.level += 1 
self.sb.prep level() 


如 果 整 群 外 星人 都 被 消灭 ， 就 将 stats.level 的 值 加 1， 并 调用 prep_level() 确 保 正 确 地 显 
示 了 新 等 级 。 


为 确保 在 开始 新 游戏 时 更 新 等 级 图 像 ， 还 需 在 玩家 单 击 按钮 Play 时 调用 prep_level(): 


alien_invasion.py def check play button(self, mouse pos): 
-- SNip-- 
if button clicked and not self.stats.game active: 
-- Snip-- 


self.sb.prep score() 
self.sb.prep level() 
-- SNip-- 


这 里 在 调用 prep_score() 后 立即 调用 prep_level()。 
现在 可 以 知道 到 了 多 少 级 ， 如 图 14-5 所 示 。 
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图 14-5 ”当前 等 级 显示 在 当前 得 分 的 正 下 方 
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注意 在 一 些 经 典 游戏 中 ， 得 分 带 有 标签 ， 如 Score、High Score 和 Level。 这 里 没有 显示 这 些 
标签 ， 游 戏 开 始 后 ， 每 个 数 的 含义 将 一 目 了 然 。 要 包含 这 些 标签 ， 只 需 在 Scoreboard 中 
调用 font.render() 前 ， 将 它们 添加 到 得 分 字符 串 中 。 


14.3.10 ”显示 余下 的 飞船 数 


最 后 来 显示 玩家 还 有 多 少 艘 飞船 , 但 使 用 图 形 而 不 是 数字 。 为 此 , 在 屏幕 左上 角 绘制 飞船 图 
像 来 指出 还 余下 多 少 艘 飞船 ， 就 像 众 多 经 典 的 街机 游戏 中 那样 。 


首先 ， 需 要 让 Ship 继承 Sprite， 以 便 创建 飞船 编组 : 


ship.py import pygame 
from pygame.sprite import Sprite 


@ class Ship(Sprite): 
"" "管理 飞船 的 类 。""" 


def init (self, ai game): 
"" "初始化 飞船 并 设置 其 起 始 位 置 。""" 
© super(). init () 
-- Snip-- 


这 里 导入 了 Sprite， 让 Ship 继承 Sprite ( 见 @ )， 并 在 init () 的 开头 调用 super() ( 见 @ )。 
接 下 来 ,需要 修改 Scoreboard， 以 创建 可 供 显 示 的 飞船 编组 。 下 面 是 其 中 的 import 语句 : 


scoreboard.py import pygame.Tfont 
from pygame.sprite import Group 


from ship import Ship 


鉴于 需要 创建 飞船 编组 ， 导 入 Group 和 Ship 类 。 
下 面 是 方法 _ in it (): 


scoreboard.py def init (self, ai game): 
"" "初始化 记录 得 分 的 属性 。""" 
self.ai game = ai game 
self.screen = ai game.screen 
-- Snip-- 
self.prep level() 
self.prep_ships() 


我 们 将 游戏 实例 赋 给 一 个 属性 ， 因 为 创建 飞船 时 需要 用 到 它 。 在 调用 prep_level() 后 调用 了 
prep_ships()。 


prep_ships() 的 代码 如 下 : 


scoreboard .py def prep ships(self): 

""" 显 示 还 余下 多 少 艘 飞船 。""" 

self.ships = Group() 

for ship number in range(self.stats.ships left): 
ship = Ship(self.ai game) 
ship.rect.x = 10 + ship number * ship.rect.width 
ship.rect.y = 10 
self. ships.add(ship) 


OO ©® 


方法 prep_ships() 创 建 一 个 空 编组 self.ships， 用 于 存储 飞船 实例 ( 见 @ )。 为 填充 这 个 编 


组 ,根据 玩家 还 有 多 少 艘 飞船 以 相应 的 次 数 运行 一 个 循环 ( 见 @ )。 在 这 个 循环 中 ， 创 建新 飞船 
并 设置 其 x 坐 标 ， 让 整个 飞船 编组 都 位 于 屏幕 左边 ， 且 每 艘 飞船 的 左边 距 都 为 10 像素 ( 见 @ )。 


还 将 了 坐标 设置 为 离 屏幕 上 边缘 10 像素 ， 让 所 有 飞船 都 出 现在 
艘 新 飞船 都 添加 到 编组 ships 中 ( 见 @ )。 


现在 需要 在 屏幕 上 绘制 飞船 了 : 


屏幕 左上 角 ( 见 @ )。 最 后 ， 将 每 


scoreboard.py def show score(self): 
""" 在 屏幕 上 绘制 得 分 、 等 级 和 余下 的 飞船 数 。”""" 
self.screen.blit(self.score image, self.score rect) 


self.screen.blit(self.high score image, self.high score rect) 


self.screen.blit(self.level image, self.level rect) 
self.ships.draw(self.screen) 


为 在 屏幕 上 显示 飞船 ， 对 编组 调用 draw()。Pygame 将 绘制 每 艘 飞船 。 
为 在 游戏 开始 时 让 玩家 知道 自己 有 多 少 稻 飞船 ,在 开始 新 游戏 时 调用 prep_ships()。 这 是 在 


AlienInvasion 的 _check_play_button() 中 进行 的 : 


alien_invasion.py def check play button(self, mouse pos): 
--SNnip-- 
if button clicked and not self.stats.game active: 
-- Snip-- 


self.sb.prep score() 
self.sb.prep level() 
self.sb.prep ships() 
-- Snip-- 


还 要 在 飞船 被 外 星人 撞 到 时 调用 prep_ships()， 从 而 在 玩家 损失 飞船 时 更 新 飞船 图 像 : 


alien_invasion.py def ship hit(self): 
"" "响应 飞船 被 外 星人 樟 到 
if self.stats.ships left > 0: 
# 将 ships left 减 1 并 更 新 记分 牌 。 
self.stats.ships left -= 1 
self.sb.prep ships() 
-- Snip-- 
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这 里 在 将 ships_left 的 值 减 1 后 调用 prep_ships()。 这 样 每 次 损失 飞船 后 , 显示 的 飞船 数 都 
是 正确 的 。 


图 14-6 显示 了 完整 的 记分 系统 ， 它 在 屏幕 左上 角 指 出 还 余下 多 少 艘 飞船。 
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图 14-6 游戏 《外 星人 人 入侵 》 的 完整 记分 系统 


动手 试 一 斌 

练习 14-5: 空前 的 最 高 分 每 当 玩 家 关闭 并 重新 开始 游戏 《外 星人 入 侵 》 时 ， 最 高 
分 都 将 被 重 置 。 请 这 样 修复 该 问题 : 调用 sys.exit() 前 将 最 高 分 写 入 文件 ， 并 在 
GameStats 中 初始 化 最 高 分 时 从 文件 中 读 取 它 。 

练习 14-6: 重 构 ” 找 出 执行 多 项 任务 的 方法 ， 对 其 进行 重 构 ， 让 代码 高 效 而 有 序 。 
例如 ， 对 于 check bullet alien collisions()， 将 在 外 星人 群 被 消灭 干净 时 开始 新 等 
级 的 代码 移 到 一 个 名 为 start new level() 的 方法 中 。 再 例如 ， 对 于 Scoreboard 的 方法 
_init ()， 将 其 中 调用 四 个 不 同方 法 的 代码 移 到 一 个 名 为 prep_images() 的 方法 中 ， 
以 缩短 方法 _init ()。 如 果 你 重 构 了 _check play button(), 方法 prep images() 也 可 
简化 check play button() 和 start game()。 


注意 ” 重 构 项 目前 ， 请 阅读 附录 D， 了 解 如 果 重 构 时 引入 了 bug， 如 何 将 项 目 恢复 到 可 
正确 运行 的 状态 。 


练习 14-7: 扩展 游戏 《外 星人 入 侵 》 想 想 如 何 扩 展 游戏 《外 星人 入 侵 》。 例如 ， 
可 以 让 外 星人 也 能 够 向 飞船 射击 , 也 可 以 为 飞船 添加 盾牌 , 使 得 只 有 从 两 边 射 来 的 子弹 
才能 摧毁 飞船 。 另 外 ， 还 可 以 使 用 像 pygame.mixer 这 样 的 模块 来 添加 声音 效果 ， 如 爆 


炸 声 和 射击 声 。 

练习 14-8: 终极 版 侧面 射击 ”模仿 项 目 “外 星人 入 侵 ” 继 续 开发 “侧面 射击 "。 添 
加 一 个 Play 按钮 ， 在 适合 的 情况 下 加 快 游戏 的 节奏 ， 并 开发 一 个 记分 系统 。 在 开发 过 
程 中 ,务必 重 构 代码 ， 并 寻找 机 会 以 本 章 没 有 介绍 的 方式 定制 该 游戏 。 


14.4 ”小 结 


在 本 章 中 ， 你 学 习 了 如 何 创建 用 于 开始 新 游戏 的 Play 按钮 ， 如 何 检 测 鼠 标 事件 ， 以 及 在 游 
戏 处 于 活动 状态 时 如 何 隐 藏 鼠标 光标 。 你 可 以 利用 学 到 的 知识 在 游戏 中 创建 其 他 按钮 如 用 于 显 
示 玩 法 说 明 的 Help 按钮 。 你 还 学 习 了 如 何 随 游戏 的 进行 调整 其 节奏 ， 如 何 实现 记分 系统 ， 以 及 
如 何以 文本 和 非 文 本 方式 显示 信息 。 


项 目 2 数据 可 视 化 


ta 
en 


; 回 
加 
A 


生成 数据 


数据 可 视 化 指 的 是 通过 可 视 化 表示 来 探索 数据 。 它 与 数据 分 析 紧 
密 相 关 ， 而 数据 分 析 指 的 是 使 用 代码 来 探索 数据 集 的 规律 和 关联 。 数 
据 集 可 以 是 用 一 行 代码 就 能 表示 的 小 型 数字 列表 ,也 可 以 是 数 千 光 字 
节 的 数据 。 

漂亮 地 呈现 数据 并 非 仅仅 关乎 漂亮 的 图 片 。 通 过 以 引 人 注 目的 简 
单方 式 呈 现 数据 ,能 让 观看 者 明白 其 含义 : 发 现 数据 集中 原本 未 知 的 
规律 和 意义 。 

所 幸 即 便 没 有 超级 计算 机 ， 你 也 能 够 可 视 化 复杂 的 数据 。 鉴 于 Python 的 高 效 性 ， 使 用 
它 在 笔记 本 电脑 上 就 能 快速 地 探索 由 数 百 万 个 数据 点 组 成 的 数据 集 。 数 据点 并 非 必 须 是 数 。 
利用 本 书 前 半 部 分 介绍 的 基本 知识 ， 也 可 对 非 数 值 数据 进行 分 析 。 

在 基因 研究 、 天 气 研 究 、 政 治 经 济 分 析 等 众多 领域 ， 人 们 常常 使 用 Python 来 完成 数据 
密集 型 工作 。 数 据 科 学 家 使 用 Python 编写 了 一 系列 优秀 的 可 视 化 和 分 析 工 具 ， 其 中 很 多 可 
供 你 使 用 。 最 流行 的 工具 之 一 是 Matplotlib， 它 是 一 个 数学 绘图 库 ， 我 们 将 使 用 它 来 制作 简 
单 的 图 表 , 如 折线 图 和 散 点 图 。 然 后 ,我 们 将 基于 随机 漫步 概念 生成 一 个 更 有 趣 的 数据 集 一 一 
根据 一 系列 随机 决策 生成 的 图 表 。 

本 章 还 将 使 用 Plotly 包 ， 它 生成 的 图 表 非 常 适合 在 数字 设备 上 显示 。Plotly 生成 的 图 表 
可 根据 显示 设备 的 尺寸 自动 调整 大 小 , 还 具备 众多 交互 特性 ,如 在 用 户 将 鼠标 指向 图 表 的 不 
同 部 分 时 突出 数据 集 的 特定 方面 。 本 章 将 使 用 Plotly 来 分 析 搓 明子 的 结果 。 


15.1 安装 Matplotlib 


本 章 将 首先 使 用 Matplotlib 来 生成 几 个 图 表 ， 为 此 需要 使 用 pip 来 安装 它 。pip 是 一 个 可 用 
于 下 载 并 安装 Python 包 的 模块 。 请 在 终端 提示 符 下 执行 如 下 命令 : 


$ python -m pip install --user matplotlib 
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这 个 命令 让 Python 运行 模块 pip， 并 将 matplotlib 包 添 加 到 当前 用 户 的 Python 安装 中 。 在 
你 的 系统 中 ， 如 果 运 行程 序 或 启动 终端 会 话 时 使 用 的 命令 不 是 python， 而 是 python3， 应 使 用 类 
似 于 下 面 的 命令 : 


$ python3 -m pip install --user matplotlib 


注意 在 macOS 系统 中 ， 如 果 这 样 不 管用 ,请 尝试 在 不 指定 标志 --user 的 情况 下 再 次 执行 该 
合 公 
"PG 


要 查看 使 用 Matplotlib 可 制作 的 各 种 图 表 ， 请 访问 其 官方 网 站 ， 浏 览 示例 画廊 。 通 过 单 击 画 
廊 中 的 图 表 ， 可 查看 生成 它们 的 代码 。 


15.2 ”绘制 简单 的 折线 图 


下 面 使 用 Matplotlib 绘制 一 个 简单 的 折线 图 ， 再 对 其 进行 定制 ， 以 实现 信息 更 丰富 的 数据 可 
视 化 效果 。 我 们 将 使 用 平方 数 序 列 1、4、9、16 和 25 来 绘制 这 个 图 表 。 


只 需 提 供 如 下 的 数 ，Matplotlib 将 完成 其 他 工作 : 


mpl_squares.py import matplotlib.pyplot as plt 
squares = [1, 4, 9, 16, 25] 
@ fig, ax = plt.subplots() 


ax.plot(squares) 


plt.show() 


首先 导入 模块 pyplot， 并 为 其 指定 别名 plt， 以 免 反 复 输 入 pyplot。( 在 线 示例 大 多 这 样 做 ， 
这 里 也 不 例外 。) 模块 pyplot 包含 很 多 用 于 生成 图 表 的 函数 。 


我 们 创建 了 一 个 名 为 squares 的 列表 ， 在 其 中 存储 要 用 来 制作 图 表 的 数据 。 然 后 ， 采 取 了 
另 一 种 常见 的 Matplotlib 做 法 一 一 调用 函数 subplots() ( 见 @ )。 这 个 函数 可 在 一 张 图 片 中 绘制 
一 个 或 多 个 图 表 。 变 量 fig 表示 整 张 图 片 。 变 量 ax 表示 图 片 中 的 各 个 图 表 ， 大 多 数 情况 下 要 使 
用 它 。 

接 下 来 调用 方法 plot()， 它 尝试 根据 给 定 的 数据 以 有 意义 的 方式 绘制 图 表 。 也 数 plt.show() 
打开 Matplotlib 查看 器 并 显示 绘制 的 图 表 ， 如 图 15-1 所 示 。 在 查看 需 中 ， 你 可 缩放 和 导航 图 形 ， 
还 可 单 击 磁盘 图 标 将 图 表 保 存 起 来 。 
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Figure 1 


省 4 了 中 QI 三 四 


0.0 0.5 1.0 15 2.0 2 二 3.0 35 4.0 


图 15-1 使 用 Matplotlib 可 制作 的 最 简单 的 图 表 


15.2.1 修改 标签 文字 和 线条 粗细 


如 图 15-1 所 示 的 图 形 表明 数 是 越 来 越 大 的 ， 但 标签 文字 太 小 、 线 条 太 细 ， 难 以 看 清楚 。 所 
幸 Matplotlib 让 你 能 够 调整 可 视 化 的 各 个 方面 。 


下 面 通过 一 些 定制 来 改善 这 个 图 表 的 可 读 性 ， 如 下 所 示 : 


mpl_squares.py 


import matplotlib.pyplot as plt 
squares = [1, 4, 9, 16, 25] 


fig, ax = plt.subplots() 


@ ax.plot(squares, linewidth=3) 


# 设置 图 表 标题 并 给 坐标 轴 加 上 标签 "。 


@ ax.set title(" 平 方 数 "，fontsize=24) 
@ ax.set xlabel(" 值 "，fontsize=14) 


ax.set ylabel(" 值 的 平方 "，fontsize=14) 


# 设置 刻度 标记 的 大 小 。 


@ ax.tick params(axis='both', labelsize=14) 


plt. show() 


参数 Linewidth ( 见 @ ) 决定 了 plot() 


绘制 的 线条 粗细 。 方法 set_title() ( 见 @ ) 给 图 表 指 


定 标 题 。 在 上 述 代 码 中 ， 出 现 多 次 的 参数 fontsize 指定 图 表 中 各 种 文字 的 大 小 。 


Q( 标签 最 好 使 用 英文 ， 以 防 出 现 文 字 显 示 问 题 。 


一 一 编者 注 
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设置 刻度 的 样式 ( 见 @ )， 其 中 指定 的 实 参 将 影响 x 轴 和 了 轴 上 的 刻度 (axes='both' )， 并 将 刻度 
标记 的 字号 设置 为 14 (labelsize=14 )。 
最 终 的 图 表 阅 读 起 来 容易 得 多 ， 如 图 15-2 所 示 : 标签 文字 更 大 ， 线 条 也 更 粗 了 。 通 常 ， 需 
尝试 不 同 的 值 ， 才 能 确定 什么 样 的 设置 生成 的 图 表 最 合适 。 
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图 15-2 ”现在 图 表 阅 读 起 来 容易 得 多 


15.2.2 ”校正 图 形 
图 形 更 容易 看 清 后 ,我 们 发 现 没有 正确 地 绘制 数据 : 折线 图 的 终点 指出 4.0 的 平方 为 25! 下 
面 来 修复 这 个 问题 。 
向 plot() 提 供 一 系列 数 时 ， 它 假设 第 一 个 数据 点 对 应 的 x 坐标 值 为 0， 但 这 里 第 一 个 点 对 应 
的 x 值 为 1。 为 改变 这 种 默认 行为 ， 可 向 plot() 同 时 提供 输入 值 和 输出 值 : en 


mpl_squares.py import matplotlib.pyplot as plt 


input values = [1, 2, 3, 4, 5] 
squares = [1, 4, 9, 16, 25] 


fig, ax = plt.subplots() 
ax.plot(input values, squares, linewidth=3) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 
-- SNip-- 


现在 plot() 将 正确 地 绘制 数据 ， 因 为 同时 提供 了 输入 值 和 输出 值 ，plot() 无 须 对 输出 值 的 生 
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成 方式 做 出 假设 。 最 终 的 图 形 是 正确 的 ， 如 图 15-3 所 示 。 
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图 15-3 ”根据 数据 正确 地 绘制 了 图 形 


使 用 plot() 时 可 指定 各 种 实 参 , 还 可 使 用 众多 函数 对 图 形 进行 定制 。 本 章 后 面 处 理 更 有 趣 的 
数据 集 时 ， 将 继续 探索 这 些 定制 函数 。 


15.2.3 ”使 用 内 置 样式 

Matplotlib 提供 了 很 多 已 经 定义 好 的 样式 ， 它 们 使 用 的 背景 色 、 网 格 线 、 线 条 粗细 、 字 体 、 
字号 等 设置 很 不 错 , 让 你 无 须 做 太 多 定制 就 可 生成 引 人 瞩 目的 可 视 化 效果 。 要 获悉 在 你 的 系统 中 
可 使 用 哪些 样式 ， 可 在 终端 会 话 中 执行 如 下 命令 : 


>>> import matplotlib.pyplot as plt 

>>> plt.style.available 

['seaborn-dark', 'seaborn-darkgrid', 'seaborn-ticks', 'fivethirtyeight', 
-- Snip-- 


要 使 用 这 些 样式 ， 可 在 生成 图 表 的 代码 前 添加 如 下 代码 行 : 


mpl_squares.py import matplotlib.pyplot as plt 


input values = [1, 2, 3, 4, 5] 
squares = [1, 4, 9, 16, 25] 


plt.style.use(l'seaborn') 
fig, ax = plt.subplots() 
-- Snip-- 
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这 些 代码 生成 的 图 表 如 图 15-4 所 示 。 可 供 使 用 的 内 置 样式 有 很 多 ， 请 尝试 使 用 它们 ， 找 出 
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图 15-4 ”内置 样式 seaborn 


15.2.4 ”使 用 scatter() 绘 制 散 点 图 并 设置 样式 

有 时 候 , 绘制 散 点 图 并 设置 各 个 数据 点 的 样式 很 有 用 。 例如 ,你 可 能 想 以 一 种 颜色 显示 较 小 
的 值 ， 用 另 一 种 颜色 显示 较 大 的 值 。 绘制 大 型 数据 集 时 ,还 可 对 每 个 点 都 设置 同样 的 样式 ， 再 使 
用 不 同 的 样式 选项 重新 绘制 某 些 点 以 示 突 出 。 


要 绘制 单个 点 ， 可 使 用 方法 scatter()。 向 它 传递 一 对 x 坐标 和 y 坐标 ， 它 将 在 指定 位 置 给 
制 一 个 点 : 


calfer_ squares.py import matplotlib.pyplot as plt 


plt.style.use( "seaborn ') 
fig, ax = plt.subplots() 
ax.scatter(2, 4) 


plt.show() 


下 面 来 设置 图 表 的 样式 , 使 其 更 有 趣 。 我 们 将 添加 标题 ,给 坐标 轴 加 上 标签 ， 并 且 确 保 所 有 
文本 都 大 到 能 够 看 清 : 


import matplotlib.pyplot as plt 


plt.style.use( "seaborn ') 
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fig, ax = plt.subplots() 
@ ax.scatter(2, 4, s=200) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 。 
ax.set title(" 平 方 数 "，fontsize=24) 
ax.set xlabel(" 值 "，fontsize=14) 
ax.set ylabel(" 值 的 平方 "，fontsize=14) 


# 设置 刻度 标记 的 大 小 。 
ax.tick params(axis="both', which='major', labelsize=14) 


plt. show() 


在 @ 人 处 ,调用 scatter() 并 使 用 参数 s 设置 绘制 图 形 时 使 用 的 点 的 尺寸 。 如 果 此 时 运行 
scatter_squares.py， 将 在 图 表 中 央 看 到 一 个 点 ， 如 图 15-5 所 示 。 
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图 15-5 ”绘制 单个 点 


15.2.5 ”使 用 scatter() 绘 制 一 系列 点 
要 绘制 一 系列 的 点 ， 可 向 scatter() 传 递 两 个 分 别 包含 x 值 和 yy 值 的 列表 ， 如 下 所 示 : 


scatter squares.py import matplotlib.pyplot as plt 


x values = [1, 2, 3, 4, 5] 
y_values = [1, 4, 9, 16, 25] 


plt.style.use('seaborn’') 
fig, ax = plt.subplots() 
ax.scatter(x values, y values, s=100) 
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# 设置 图 表 标 题 并 给 坐标 轴 指 定 标签 
-- Snip-- 


列表 x_values 包含 要 计算 平方 值 的 数 ， 列 表 y_values 包含 前 述 数 的 平方 值 。 将 这 些 列表 传 
递 给 scatter() 时 ,Matplotlib 依次 从 每 个 列表 中 读 取 一 个 值 来 绘制 一 个 点 。 要 绘制 的 点 的 坐标 分 
别 为 (1, 1)、(2, 4)、(3, 9)、(4, 16) 和 (5, 23)， 最 终 的 结果 如 图 15-6 所 示 。 
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图 15-6 由 多 个 点 组 成 的 散 点 图 


15.2.6 ”自动 计算 数据 


手工 计算 列表 要 包含 的 值 可 能 效率 低下 , 需要 绘制 的 点 很 多 时 尤其 如 此 。 我 们 不 必 手 工 计算 
包含 点 坐标 的 列表 ， 可 以 用 Python 循环 来 完成 。 5 


下 面 是 绘制 1000 个 点 的 代码 : 


scalfer_ squares.py import matplotlib.pyplot as plt 


@ x values = range(1, 1001) 
y_values = [x**2 for x in x_values] 


plt.style.use( "seaborn ') 
fig, ax = plt.subplots() 
@ ax.scatter(x values, y_ values, s=10) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 
-- Ship-- 
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# 设置 每 个 坐标 轴 的 取 值 范围 。 
@ ax.axis([0，1100，0，1100000]) 


plt. show() 


首先 创建 了 一 个 包含 x 值 的 列表 ， 其 中 包含 数 1~1000 ( 见 @ ), 接 下 来 ,是 一 个 生成 y 值 的 
列表 解析 , 它 遍历 x 值 ( for x in x_values ), 计算 其 平方 值 (x**2 ), 并 将 结果 存储 到 列表 y_values 
中 。 然 后 ,将 输入 列表 和 输出 列表 传递 给 scatter() ( 见 @@ )。 这 个 数据 集 较 大 ， 因 此 将 点 设置 得 
较 小 。 

在 @ 处 ,使 用 方法 axis() 指 定 了 每 个 坐标 轴 的 取 值 范围 。 方 法 axis() 要 求 提供 4 个 值 : x 和 
坐标 轴 的 最 小 值 和 最 大 值 。 这 里 将 * 坐标 轴 的 取 值 范围 设置 为 0 ~ 1100, 并 将 ?坐标 轴 的 取 值 范 
围 设 置 为 0 ~ 1 100 000。 结 果 如 图 15-7 所 示 。 


加 Figure 1 
平方 数 
1000000 
800000 
家 600000 
明 
400000 
200000 
0 
0 200 400 600 800 1000 
值 
舍 扣 字 中 口 三 


图 15-7 ”对 Python 来 说 ， 绘 制 1000 个 点 与 绘制 $ 个 点 一 样 容易 


15.2.7 自 定 义 颜 色 


要 修改 数据 点 的 颜色 ， 可 向 scatter() 传 递 参 数 <， 并 将 其 设置 为 要 使 用 的 颜色 的 名 称 〈 放 
在 引号 内 )， 如 下 所 示 : 


ax.scatter(x values, y values, c='red', s=10) 


还 可 使 用 RGB 颜色 模式 自 定义 颜色 。 要 指定 自 定义 颜色 ， 可 传递 参数 c， 并 将 其 设置 为 一 
个 元 组 ， 其 中 包含 三 个 0~1 的 小 数值 ， 分 别 表示 红色 、 绿 色 和 蓝 色 的 分 量 。 例 如 ， 下 面 的 代码 
行 创建 一 个 由 淡 绿 色 点 组 成 的 散 点 图 : 
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ax.scatter(x values, y values, c=(0, 0.8, 0), s=10) 


值 越 接 近 0， 指 定 的 颜色 越 深 ; 值 越 接 近 1， 指 定 的 颜色 越 浅 。 


15.2.8 ”使 用 颜色 映射 
颜色 映射 ( colormap ) 是 一 系列 颜色 ， 从 起 始 颜 色 渐 变 到 结束 颜色 。 在 可 视 化 中 ， 颜 色 映 射 
用 于 突出 数据 的 规律 。 例 如 ,你 可 能 用 较 浅 的 颜色 来 显示 较 小 的 值 ， 并 使 用 较 深 的 颜色 来 显示 较 
大 的 值 。 
模块 pyplot 内 置 了 一 组 颜色 映射 。 要 使 用 这 些 颜色 映射 需要 告诉 pyplot 该 如 何 设置 数据 
中 每 个 点 的 颜色 。 下 面 演示 了 如 何 根据 每 个 点 的 值 来 设置 其 颜色 : 


? Ly 


scatter_squares.py import matplotlib.pyplot as plt 


x_values = range(1, 1001) 
y values = [x**2 for x in x values] 


ax.scatter(x values, y values, c=y values, cmap=plt.cm.Blues, s=10) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 


-- SNip-- 
我 们 将 参数 c 设置 成 了 一 个 了 值 列表 ， 并 使 用 参数 cmap 告诉 pyplot 使 用 哪个 颜色 映射 。 这 
些 代码 将 y 值 较 小 的 点 显示 为 浅 蓝 色 ， 并 将 y 值 较 大 的 点 显示 为 深蓝 色 ， 绪 果 如 图 15-8 所 示 。 
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图 15-8 ”使 用 颜色 映射 Blues 的 图 表 
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注意 要 了 解 pyplot 中 所 有 的 颜色 映射 ， 请 访问 Matplotlib 网 站 主页 ， 单 击 Examples， 向 下 滚 
动 到 Color， 再 单 击 Colormaps reference。 


15.2.9 自动 保存 图 表 
要 让 程序 自动 将 图 表 保 存 到 文件 中 ， 可 将 调用 plt.show() 替 换 为 调用 plt.savefig(): 


plt.savefig('squares plot.png', bbox inches='tight') 


第 一 个 实 参 指定 要 以 什么 文件 名 保存 图 表 , 这 个 文件 将 存储 到 scatter_ squares.py 所 在 的 目录 。 
第 二 个 实 参 指定 将 图 表 多 余 的 空白 区 域 裁剪 掉 。 如 果 要 保留 图 表 周 围 多 余 的 空白 区 域 , 只 需 省 略 
这 个 实 参 即 可 。 


动手 试 一 斌 


练习 15-1: 立方 。 数 的 三 次 方 称 为 立方 。 请 绘制 一 个 图 形 ， 显 示 前 5 个 整数 的 立 


方 值 。 再 绘制 一 个 图 形 ， 显 示 前 5000 个 整数 的 立方 值 。 
练习 15-2: 彩色 立方 ”给 前 面 绘 制 的 立方 图 指定 颜色 映射 。 


15.3 ”随机 漫步 


本 节 将 使 用 Python 来 生成 随机 漫步 数据 , 再 使 用 Matplotlib 以 引 人 瞩 目的 方式 将 这 些 数 据 呈 
现 出 来 。 随 机 漫步 是 这 样 行走 得 到 的 路 径 : 每 次 行走 都 是 完全 随机 的 、 没 有 明确 的 方向 ,结果 是 
系列 随机 决策 决定 的 。 你 可 以 将 随机 漫步 看 作 蚂 蚁 在 尝 头 转向 的 情况 下 , 每 次 都 沿 随机 的 方 
向 前 行 所 经 过 的 路 径 。 

在 自然 界 、 物 理学 、 生 物 学 、 化 学 和 经 济 领域 ,随机 漫步 都 有 其 实际 用 途 。 例 如 ,漂浮 在 水 
滴 上 的 花粉 因 不 断 受到 水 分 子 的 挤 压 而 在 水 面 上 移动 。 水 滴 中 的 分 子 运 动 是 随机 的 , 因此 花粉 在 
水 面 上 的 运动 路 径 犹如 随机 漫步 。 我 们 稍 后 编写 的 代码 将 模拟 现实 世界 的 很 多 情形 。 


15.3.1 创建 RandomWalk 类 


为 模拟 随机 漫步 ， 将 创建 一 个 名 为 Randomwalk 的 类 ， 它 随机 地 选择 前 进 方向 。 这 个 类 需要 
三 个 属性 : 一 个 是 存储 随机 漫步 次 数 的 变量 ,其 他 两 个 是 列表 , 分 别 存储 随机 漫步 经 过 的 每 个 点 
的 x 坐标 和 y 坐标。 


RandomWalk 类 只 包含 两 个 方法 : 方法 _init _() 和 有]]_walk(),， 后 者 计算 随机 漫步 经 过 的 
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所 有 点 。 先 来 看 看 _init ()， 如 下 所 示 : 


random walk.py 四 from random import choice 


class RandomWalk: 


""" 一 个 生成 随机 漫步 数据 的 类 。""" 


© def init (self, num points=5000): 
""" 初 始 化 随机 漫步 的 属性 。""" 
self.num points = num points 


# 所 有 随机 漫步 都 始 于 (0，0)。 
(3 self.x values = [0] 
self.y values = [0] 


为 做 出 随机 决策 ， 将 所 有 可 能 的 选择 都 存储 在 一 个 列表 中 ， 并 在 每 次 决策 时 都 使 用 模块 
random 中 的 choice() 来 决定 使 用 哪 种 选择 ( 见 @ )。 接 下 来 ,将 随机 漫步 包含 的 默认 点 数 设 置 为 
5000。 这 个 数 大 到 足以 生成 有 趣 的 模式 ， 又 小 到 可 确保 能 够 快速 地 模拟 随机 漫步 ( 见 @ )。 然后， 
在 @ 处 创建 两 个 用 于 存储 x 值 和 y 值 的 列表 ， 并 让 每 次 漫步 都 从 点 (0, 0) 出 发 。 


15.3.2 ”选择 方向 


我 们 将 使 用 方法 fill walk() 来 生成 漫步 包含 的 点 并 决定 每 次 漫步 的 方向 ， 如 下 所 示 。 请 将 
这 个 方法 添加 到 random walk.py 中 : 


random_walk.py def fill walk(self): 
"mu 计 算 随 机 漫步 包含 的 所 有 点 。""" 


# 不 断 漫步 ， 直 到 列表 达到 指定 的 长 度 。 


© while len(self.x values) < self.num points: 


# 决定 前 进 方向 以 及 沿 这 个 方向 前 进 的 距离 。 
© x direction = choice([1, -1]) 


x distance = choice([0, 1, 2, 3, 4]) 
日 x step = x direction * x distance 


y_direction = choice([1, -1]) 
y_distance = choice([0, 1, 2, 3, 4]) 
@ y_Sstep = y direction * y distance 


# 拒绝 原 地 踏步 。 
© if x step == 0 and y step == 0: 
continue 


# 计算 下 一 个 点 的 x 值 和 yy 值 。 
© x = self.x values[-1] + x step 


286 第 15 章 生成 数据 


y = self.y values[-1] + y_step 


self.x values.append(x) 
self.y values.append(y) 


@ 处 建立 了 一 个 循环 ， 它 不 断 运行 ， 直 到 漫步 包含 所 需 的 点 数 。 方 法 fill_walk() 的 主要 部 
分 告诉 Python 如 何 模 拟 四 种 漫步 决定 : 向 右 走 还 是 向 左 走 ? 沿 指定 的 方向 走 多 远 ? 向 上 走 还 是 
向 下 走 ? 沿 选 定 的 方向 走 多 远 ? 


使 用 choice([1, -1]) 给 x_direction 选择 一 个 值 ， 结 果 要 么 是 表示 向 右 走 的 1， 要 么 是 表示 
向 左 走 的 -1 ( 见 @ )。 接 下 来 ，choice([0, 1, 2, 3, 4]) 随 机 地 选择 一 个 0 ~4 的 整数 ,告诉 Python 
沿 指 定 的 方向 走 多 远 (x_distance ),。 通过 包含 0, 不 仅 能 够 同时 沿 两 个 轴 移 动 ， 还 能 够 只 沿 一 个 
轴 移 动 。 

在 人 @ 和 @ 处 ,将 移动 方向 乘 以 移动 距离 ,确定 沿 x 轴 和 yy 轴 移 动 的 距离 。 如 果 x_step 为 正 将 
向 右 移动 ， 为 负 将 向 左 移动 ， 为 零 将 垂直 移动 ; 如 果 y_step 为 正 将 向 上 移动 ， 为 负 将 向 下 移动 ， 
为 零 将 水 平移 动 。 如 果 x_step 和 y_step 都 为 零 ， 则 意味 着 原 地 踏步 。 我 们 拒绝 这 样 的 情况 ， 接 
着 执行 下 一 次 循环 ( 见 @ )。 

为 获取 漫步 中 下 一 个 点 的 x 值 , 将 x_step 与 x_values 中 的 最 后 一 个 值 相 加 ( 见 @ ), 对 y 值 
也 做 相同 的 处 理 。 获 得 下 一 个 点 的 x 值 和 yy 值 后 ， 将 它们 分 别 附加 到 列表 x_values 和 y_values 
的 末尾 。 


15.3.3 ”绘制 随机 漫步 
下 面 的 代码 将 随机 漫步 的 所 有 点 都 绘制 出 来 : 


rw_visualpy import matplotlib.pyplot as plt 
from random walk import RandomWalk 


# 创建 一 个 RandomWalk 实例 。 

@ rw = RandomWalk() 
rw.fill walk() 
# 将 所 有 的 点 者 绘制 出 来 。 
plt.style.use('classic') 
fig, ax = plt.subplots() 

@ ax.scatter(rw.x values, rw.y values, s=15) 
plt.show() 


首先 导入 模块 pyplot 和 RandomWalk 类 ， 再 创建 一 个 Randomwalk 实例 并 将 其 存储 到 rw 中 
( 见 @ )， 并 且 调 用 fill walk()。 在 @ 处 ,将 随机 漫步 包含 的 x 值 和 yy 值 传递 给 scatter() ， 并 选 
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择 合适 的 点 尺寸 。 图 15-9 显示 了 包含 $000 个 点 的 随机 漫步 图 。( 本 节 的 示意 图 未 包含 Matplotlib 
查看 器 的 界面 ， 但 你 运行 rw_visual.py 时 会 看 到 。) 
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图 15-9 包含 5000 个 点 的 随机 漫步 


15.3.4 ”模拟 多 次 随机 漫步 


每 次 随机 漫步 都 不 同 , 因此 探索 可 能 生成 的 各 种 模式 很 有 趣 。 要 在 不 多 次 运行 程序 的 情况 下 
使 用 前 面 的 代码 模拟 多 次 随机 漫步 ， 一 种 办 法 是 将 这 些 代 码 放 在 一 个 while 循环 中 ， 如 下 所 示 : 


rw_visualpy import matplotlib.pyplot as plt 


from random walk import RandomWalk 


# 只 要 程序 处 于 活动 状态 ， 就 不 断 地 模拟 随机 漫步 。 
while True: 


# 创建 一 个 RandomWalk 实例 。 
rw = RandomWalk() 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 
plt.style.use('classic') 

fig, ax = plt.subplots() 

ax.scatter(rw.x values, Iw.y values, s=15) 
plt. show() 


keep_running = input("Make another walk? (y/n): ") 
if keep running == 'N': 
break 
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这 些 代码 模拟 一 次 随机 漫步 ， 在 Matplotlib 查看 器 中 显示 结果 ， 再 在 不 关闭 查看 器 的 情况 下 
暂停 。 如 果 关 闭 查 看 器 ， 程 序 将 询问 是 否 要 再 模拟 一 次 随机 漫步 。 如 果 输 入 y， 可 模拟 在 起 点 附 
近 进 行 的 随机 漫步 、 大 多 沿 特定 方向 偏离 起 点 的 随机 漫步 、 漫 步 点 分 布 不 均匀 的 随机 漫步 , 等 等 。 
要 结束 程序 ， 请 输入 n。 


15.3.5 “设置 随机 漫步 图 的 样式 
本 节 将 定制 图 表 ， 以 突出 每 次 漫步 的 重要 特征 ， 并 让 分 散 注 意 力 的 元 素 不 那么 显眼 。 为 此 ， 
我 们 确定 要 突出 的 元 素 ， 如 漫步 的 起 点 、 终 点 和 经 过 的 路 径 。 接 下 来 确定 要 使 其 不 那么 显眼 的 元 
素 ， 如 刻度 标记 和 标签 。 最 终 的 结果 是 简单 的 可 视 化 表示 ， 清 楚 地 指出 了 每 次 漫步 经 过 的 路 径 。 
1. 给 点 着 色 


我 们 将 使 用 颜色 映射 来 指出 漫步 中 各 点 的 先后 顺序 , 并 删除 每 个 点 的 黑色 轮廓 ,让 其 颜色 更 
为 明显 。 为 根据 漫步 中 各 点 的 先后 顺序 来 着 色 ， 传 递 参 数 c， 并 将 其 设置 为 一 个 列表 ， 其 中 包含 


各 点 的 先后 顺序 。 这 些 点 是 按 顺 序 绘制 的 ， 因 此 给 参数 c 指定 的 列表 只 需 包含 数 0~4999， 如 下 
所 示 : 
rw visual.py --5N1p-- 
while True: 


# 创建 一 个 RandomWalk 实例 
rw = RandomWalk() 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 
plt.style.use('classic') 
fig, ax = plt.subplots() 
@ point numbers = range(rw.num points) 
ax.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolors="'none' ,s=15) 
plt. show() 


keep running = input("Make another walk? (y/n): ") 
-- SNip-- 


在 @ 处 , 使 用 range() 生 成 了 一 个 数字 列表 ， 其 中 包含 的 数 与 漫步 包含 的 点 数量 相同 。 接 下 
来 ， 将 这 个 列表 存储 在 point_numbers 中 ， 以 便 后 面 使 用 它 来 设置 每 个 漫步 点 的 颜色 。 将 参数 c 
设置 为 point_numbers， 指 定 使 用 颜色 映射 Blues， 并 传递 实 参 edgecolors='none' 以 删除 每 个 点 
周围 的 轮廓 。 最 终 的 随机 漫步 图 从 浅 蓝 色 渐 变 为 深蓝 色 ， 如 图 15-10 所 示 。 
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图 15-10 ”使 用 颜色 映射 Blues 着 色 的 随机 漫步 图 


2. 重新 绘制 起 点 和 终点 

除了 给 随机 漫步 的 各 个 点 着 色 , 以 指出 其 先后 顺序 外 , 如 果 还 能 呈现 随机 漫步 的 起 点 和 终点 
就 好 了 。 为 此 , 可 在 绘制 随机 漫步 图 后 重新 绘制 起 点 和 终点 。 这 里 让 起 点 和 终点 更 大 并 显示 为 不 
同 的 颜色 ， 以 示 突 出 ， 如 下 所 示 : 


rwvisual.py --5N1p-- 
while True: 
-- SNip-- 
ax.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolors="'none' , s=15) 


# 突出 起 点 和 终点 。 

ax.scatter(0, 0, c='green', edgecolors="'none', s=100) 

ax.scatter(rw.x values[-1], rw.y_ values[-1], c="'red', edgecolors='none', 
s=100) 


plt. show() 
-- Snip-- 


为 突出 起 点 , 使 用 绿色 绘制 点 (0, 0)， 并 使 其 比 其 他 点 大 ( s=100 )。 为 突出 终点 ,在 漫步 包含 
的 最 后 一 个 x 值 和 yy 值 处 绘制 一 个 点 ,将 其 颜色 设置 为 红色 ， 并 将 尺寸 设置 为 100。 务 必 将 这 些 
代码 放 在 调用 plt.show() 的 代码 前 面 ， 确 保 在 其 他 点 之 上 绘制 起 点 和 终点 。 


如 果 现 在 运行 这 些 代 码 ， 将 能 准确 地 知道 每 次 随机 漫步 的 起 点 和 终点 。( 如 果 起 点 和 终点 不 
明显 ， 请 调整 颜色 和 大 小 ， 直 到 明显 为 止 。) 
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3. 隐藏 坐标 轴 


下 面 来 隐藏 这 个 图 表 的 坐标 轴 ， 以 免 分 散 观察 者 对 随机 漫步 路 径 的 注意 力 。 要 隐藏 坐标 轴 ， 
可 使 用 如 下 代码 : 


rw visual.py --5N1p-- 
while True: 
-- Ship-- 
ax.scatter(rw.x values[-1], rw.y values[-1], c="'red', edgecolors="'none', 
s=100) 


# 隐藏 坐标 轴 。 
@ ax.get xaxis().set visible(False) 
ax.get yaxis().set visible(False) 


plt. show() 
-- Snip-- 


为 修改 坐标 轴 , 使 用 方法 ax.get_xaxis() 和 ax.get yaxis() ( 见 @ ) 将 每 条 坐标 轴 的 可 见 性 都 
设置 为 False。 随 着 对 数据 可 视 化 的 不 断 学 习 和 实践 ， 你 会 经 常 看 到 这 种 串 接 方法 的 方式 。 


如 果 现 在 运行 rw_visualpy， 你 将 看 到 一 系列 图 形 ， 但 看 不 到 坐标 轴 。 
4. 增加 点 数 


下 面 来 增加 点 数 ， 以 提供 更 多 数据 。 为 此 ,在 创建 RandomWalk 实例 时 增 大 num_points 的 值 ， 
并 在 绘图 时 调整 每 个 点 的 大 小 ， 如 下 所 示 : 


rw visual.py --5N1p-- 
while True: 
# 创建 一 个 RandomWalk 实例 
rw = RandomWalk(50 000) 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 

plt.style.use('classic') 

fig, ax = plt.subplots() 

point numbers = range(rw.num points) 

ax.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolor="'none' ,s=1) 

-- SNip-- 


这 个 示例 模拟 了 一 次 包含 50 000 个 点 的 随机 漫步 〈 以 模拟 现实 情况 )， 并 将 每 个 点 的 大 小 都 
设置 为 1。 最 终 的 随机 漫步 图 更 稀 琉 ， 犹 如 云 失 ， 如 岁 15-11 所 示 。 如 你 所 见 ， 我 们 使 用 简单 的 
散 点 图 制作 出 了 一 件 艺 术 品 ! 
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图 15-11 包含 50 000 个 点 的 随机 漫步 
请 尝试 修改 上 述 代码 , 看 看 将 漫步 包含 的 点 数 增加 到 多 少 后 , 程序 的 运行 速度 变 得 极其 缓慢 
或 绘制 出 的 图 形变 得 很 难看 。 
5. 调整 尺寸 以 适合 屏幕 


图 表 适 合 屏幕 大 小 时 , 更 能 有 效 地 将 数据 中 的 规律 呈现 出 来 。 为 让 绘图 窗口 更 适合 屏幕 大 小 ， 
可 以 像 下 面 这 样 调整 Matplotlib 输出 的 尺寸 : 


rwvisual.py --5Nip-- 
while True: 
# 创建 一 个 RandomWalk 实例 。 
rw = RandomWalk(50 000) 
rw.fill] walk() 


# 将 所 有 的 点 都 绘制 出 来 
plt.style.use('classic') 

fig, ax = plt.subplots(figsize=(15, 9)) 
-- Snip-- 


创建 图 表 时 ， 可 传递 参数 figsize 以 指定 生成 的 图 形 的 尺寸 。 需 要 给 参数 figsize 指定 一 个 
元 组 ， 向 Matplotlib 指出 绘图 窗口 的 尺寸 ， 单 位 为 英寸 ”。 


Matplotlib 假定 屏幕 分 辩 率 为 100 像素 /英寸 。 如 果 上 述 代码 指定 的 图 表 尺寸 不 合适 ， 可 根据 
需要 调整 数字 。 如 果 知 道 当 前 系统 的 分 辨 率 ， 可 通过 参数 dpi 向 ee 
以 有 效 利用 可 用 的 屏幕 空间 ， 如 下 所 示 : 


1 英寸 2.54 厘米 。 一 一 编者 注 
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fig, ax = plt.subplots(figsize=(10, 6), dpi=128) 


动手 试 一 试 

练习 15-3: 分 子 运 动 ” 修 改 rw visual.jpy， 将 其 中 的 ax.scatter() 替 换 为 ax.plot()。 
为 模拟 花粉 在 水 滴 表 面 的 运动 路 径 ， 向 plt.plot() 传 递 rw.x values 和 rw.y values， 
并 指定 实 参 linewidth。 请 使 用 5000 个 点 而 不 是 50 000 个 点 。 

练习 15-4: 改进 的 随机 漫步 在 类 RandomWalk 中 ，x step 和 y step 是 根据 相同 的 
条 件 生 成 的 : 从 列表 [1，-1] 中 随机 选择 方向 ， 并 从 列表 [0，1，2，3，4] 中 随机 选择 距 
离 。 请 修 政 这 些 列表 中 的 值 ， 看 看 对 随机 漫步 路 径 有 何 影 响 。 尝 试 使 用 更 长 的 距离 选择 


列表 (如 0~8), 或 者 将 -1] 从 Xx 或 y 方 向 列表 中 删除 。 


练习 1S-S: 重 构 方法 fill walk() 很 长 。 请 新 建 一 个 名 为 get_step() 的 方法 ， 用 于 
确定 每 次 漫步 的 距离 和 方向 ， 并 计算 每 一 步 。 然 后 ， 在 fill walk() 中 调用 get step() 


两 次 : 


x step = self.get step() 
ystep = self.get step() 


通过 这 样 的 重 构 ， 可 缩小 方法 fill walk()， 让 它 阅读 和 理解 起 来 更 容易 。 


15.4 ”使 用 Plotly 模拟 掷 般 子 


本 节 将 使 用 Python 包 Ploty 来 生成 交互 式 图 表 。 需 要 创建 在 浏览 器 中 显示 的 图 表 时 ，Plotly 
很 有 用 ， 因 为 它 生成 的 图 表 将 自动 缩放 以 适合 观看 者 的 屏幕 。Plotly 生成 的 图 表 还 是 交互 式 的 : 
用 户 将 鼠标 指向 特定 元 素 时 ， 将 突出 显示 有 关 该 元 素 的 信息 。 


在 这 个 项 目 中 , 我 们 将 对 掷 骨 子 的 结果 进行 分 析 。 抛 搓 一 个 6 面 的 常规 山子 时 ， 可 能 出 现 的 
结果 为 1~6 点 ， 且 出 现 每 种 结果 的 可 能 性 相同 。 然 而 ， 如 果 同 时 掷 两 个 仍 子 ， 某 些 点 数 出 现 的 
可 能 性 将 比 其 他 点 数 大 。 为 确定 哪些 点 数 出 现 的 可 能 性 最 大 , 将 生成 一 个 表示 掷 贷 子 结果 的 数据 
集 ， 并 根据 结果 绘制 一 个 图 形 。 


在 数学 领域 ， 掷 仍 子 常 被 用 来 解释 各 种 数据 分 析 类 型 ， 而 它 在 赌场 和 其 他 博弈 场景 中 也 有 实 
际 应 用 ， 在 游戏 《大 富翁 》 以 及 众多 角色 扮演 游戏 中 亦 如 此 。 


15.4.1 安装 Plotly 


要 安装 Plotly， 可 像 本 章 前 面 安装 Matplotlib 那样 使 用 pip: 
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$ python -m pip install --user plotly 


在 前 面 安装 Matplotlib 时 ， 如 果 使 用 了 python3 之 类 的 命令 ， 这 里 也 要 使 用 同样 的 命令 。 


要 了 解 使 用 Plotly 可 创建 什么 样 的 图 表 , 请 在 其 官方 网 站 查看 图 表 类 型 画廊 。 每 个 示例 都 包 
含 源 代码 ， 让 你 知道 这 些 图 表 是 如 何 生成 的 。 


15.4.2 ”创建 Die 类 
为 模拟 掷 一 个 鹏 子 的 情况 ， 我 们 创建 下 面 的 类 ， 


die.py from random import randint 


class Die: 


"表示 一 个 服 子 的 类 。" 


© def init (self, num sides=6): 
i 懂 子 默认 为 6 面 。""" 
self.num sides = num sides 


def roll(self): 
" "返回 一 个 位 于 1 和 考 子 面 数 之 间 的 随机 值 。""" 
© return randint(1, self.num sides) 


方法 _init _() 接 受 一 个 可 选 参 数 。 创 建 这 个 类 的 实例 时 ， 如 果 没 有 指定 任何 实 参 ， 面 数 默 
认为 6; 如 果 指 定 了 实 参 ,这 个 值 将 用 于 设置 角子 的 面 数 ( 见 @ )。 骨 子 是 根据 面 数 命名 的 ，6 面 
的 仍 子 名 为 D6，8 面 的 仍 子 名 为 D8， 依 此 类 推 。 


方法 fol1() 使 用 函数 randint() 来 返回 一 个 1 和 面 数 之 间 的 随机 数 ( 见 @ )。 这 个 函数 可 能 返 
回 起 始 值 1、 终 止 值 num_sides 或 这 两 个 值 之 间 的 任何 整数 。 


15.4.3” 撕 般 子 


使 用 这 个 类 来 创建 图 表 前 ， 先 来 撕 D6， 将 结果 打印 出 来 ， 并 确认 结果 是 合理 的 : 15 
die visual.py from die import Die 
# 创建 一 个 D6。 
@ die = Die() 


# 据 几 次 鹏 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [] 
@ for roll num in range(100): 
result = die.roll() 
results.append(result) 


print(results) 
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在 @ 处 ,创建 一 个 Die 实例 ， 其 面 数 为 默认 值 6。 在 @ 处 ， 撕 骨 子 100 次 ， 并 将 每 次 的 结果 
都 存储 在 列表 results 中 。 下 面 是 一 个 示例 结果 集 : 


[4， 6， 5， 6， 1; 5， 6， 3， 5， 3， 5， 3， 2， 2， 1 
1， 1， 4， 2， 3， 6， 4， 2， 6， 4， 1， 3， 2， 5， 6， 3， 
3， 5， 1; 4， 5， 5， 2， 33 3， 1， 2， 3， 5， 6， 2， 
SB 5， 2 2， 6， 4， 1， 4， 5， 1， 1， 1， 4， 5， 35 
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通过 快速 浏览 这 些 结果 可 知 ，Die 类 似乎 没有 问题 。 我 们 见 到 了 值 1 和 6， 表 明 返 回 了 最 大 
和 最 小 的 可 能 值 ; 没有 见 到 0 或 7, 表明 结果 都 在 正确 的 范围 内 ; 还 看 到 了 1 ~ 6 的 所 有 数字 , 表 
明 所 有 可 能 的 结果 都 出 现 了 。 下 面 来 确定 各 个 点 数 都 出 现 了 多 少 次 。 


15.4.4 ”分 析 结 
为 分 析 掷 一 个 D6 的 结果 ， 计 算 每 个 点 数 出 现 的 次 数 : 


die visualpy --5Nip-- 
# 挪 几 次 典 子 并 将 结 采 存储 在 一 个 列表 中 ， 
results = [| 


@ for roll num in range(1000): 
result = die.roll() 
results.append(result) 


# 分 析 结果 。 
frequencies = [] 
@ for value in range(1, die.num sides+1): 


(3 frequency = results.count(value) 
@ frequencies.append(frequency) 
print(frequencies) 


由 于 将 使 用 Plotly 来 分 析 , 而 不 是 将 结果 打印 出 来 , 因此 可 将 模拟 找 骨 子 的 次 数 增加 到 1000 
( 见 @ )。 为 分 析 结 果 ， 我 们 创建 空 列表 frequencies， 用 于 存储 每 种 点 数 出 现 的 次 数 。 在 @ 处 ， 
遍历 可 能 的 点 数 (这 里 为 1~ 6 )， 计 算 每 种 点 数 在 results 中 出 现 了 多 少 次 ( 见 @ )， 并 将 这 个 值 
附加 到 列表 frequencies 的 末尾 ( 见 @ )。 接 下 来 ， 在 可 视 化 之 前 将 这 个 列表 打印 出 来 : 


[155，167，168，170，159，181] 


结果 看 起 来 是 合理 的 : 有 6 个 值 ， 对 应 搓 D6 时 可 能 出 现 的 每 个 点 数 ; 另外 ， 没 有 任何 点 数 
出 现 的 频率 比 其 他 点 数 高 很 多 。 下 面 来 可 视 化 这 些 结果 。 


15.4.5 ”绘制 直方 图 
有 了 频率 列表 ,就 可 以 绘制 一 个 表示 结果 的 直方 图 了 。 直方 图 是 一 种 条 形 图 ,指出 了 各 种 结 
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果 出 现 的 频率 。 创 建 这 种 直方 图 的 代码 如 下 : 


die visualpy from plotly.graph objs import Bar, Layout 
from plotly import offline 


from die import Die 
-- SNip-- 


# 分 析 结 果 。 

frequencies = [] 

for value in range(1, die.num sides+1): 
frequency = results.count(value) 
frequencies.append(frequency) 


# 对 结果 进行 可 视 化 。 
@ x values = list(range(1, die.num sides+1)) 
@ data = [Bar(x=x_values, y=frequencies)] 


@ x axis config = {'title': ' 结 果 '} 
y_axis config = {'title': ' 结 果 的 频 举 '} 
@ my_layout = Layout(title= ' 搓 一 个 D6 1000 次 的 结果 '， 
xaxis=x axis config, yaxis=y axis config) 
©@ offline.plot({'data': data, 'layout': my layout}, filename="d6.html') 


为 创建 直方 图 ， 需 要 为 每 个 可 能 出 现 的 点 数 生 成 一 个 条 形 。 我 们 将 可 能 出 现 的 点 数 ( 1 到 内 
子 的 面 数 ) 存储 在 一 个 名 为 x_values 的 列表 中 ( 见 @ )。Plotly 不 能 直接 接受 函数 range() 的 结果 ， 
因此 需要 使 用 函数 list() 将 其 转换 为 列表 。Plotly 类 Bar() 表 示 用 于 绘制 条 形 图 的 数据 集 ( 见 @ )， 
需要 一 个 存储 x 值 的 列表 和 一 个 存储 y 值 的 列表 。 这 个 类 必须 放 在 方 括号 内 ， 因 为 数据 集 可 能 
含 多 个 元 素 。 

每 个 坐标 轴 都 能 以 不 同 的 方式 进行 配置 ， 而 每 个 配置 选项 都 是 一 个 字典 元 素 。 这 里 只 设置 了 
坐标 轴 标 签 ( 见 @ )。 类 Layout() 返 回 一 个 指定 网 表 布 局 和 配置 的 对 象 ( 见 @ )。 这 里 设置 了 图 表 
名 称 ， 并 传人 了 x 轴 和 ?了 轴 的 配置 字典 。 


为 生成 图 表 ， 我 们 调用 了 函数 offline.plot() ( 见 @ )。 这 个 函数 需要 一 个 包含 数据 和 布局 
对 象 的 字典 ， 还 接受 一 个 文件 名 ， 指 定 要 将 图 表 保 存 到 哪里 。 这 里 将 输出 存储 到 文件 d6.html。 


运行 程序 die_visual.py 时 , 可 能 打开 浏览 器 并 显示 文件 d6.html。 如 果 没 有 自动 显示 d6.html， 
可 在 任意 Web 浏览 器 中 新 建 一 个 标签 页 ， 再 在 其 中 打开 文件 d6.html ( 它 位 于 die_visual.py 所 在 
的 文件 夹 中 ), 你 将 看 到 一 个 类 似 于 图 15-12 所 示 的 图 表 。( 为 方便 印刷 , 我 稍微 修改 了 这 个 图 表 。 
在 默认 情况 下 ，Plotly 所 生成 图 表 的 文本 比 图 15-12 所 示 的 要 小 。) 
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掷 一 个 D6 1000 次 的 结果 


络 果 Exporttoplotlyy 
图 15-12 使 用 Plotly 创建 的 简单 条 形 图 
注意 ，Plotly 让 这 个 图 表 具 有 交互 性 :如果 将 鼠标 指向 其 中 的 任意 条 形 ， 就 能 看 到 与 之 相关 


联 的 数据 。 在 同一 个 图 表 中 绘制 多 个 数据 集 时 ， 这 项 功能 特别 有 用 。 另 外 , 注意 到 右上 角 有 一 些 
图 标 ， 让 你 能 够 平移 和 缩放 图 表 以 及 将 其 保存 为 图 像 。 


15.4.6 ”同时 掷 两 个 贷 子 

同时 掷 两 个 仍 子 时 ， 得 到 的 点 数 更 多 ,结果 分 布 情况 也 不 同 。 下 面 来 修改 前 面 的 代码 ， 创 建 
两 个 D6 以 模拟 同时 搓 两 个 仍 子 的 情况 。 每 次 搓 两 个 仍 子 时 ， 都 将 两 个 蜗 子 的 点 数 相 加 ， 并 将 结 
果 存 储 在 results 中 。 请 复制 die_visual.py 并 将 其 保存 为 dice_visual.py， 青 做 如 下 修改 : 


dice visual.py from plotly.graph objs import Bar, Layout 
from plotly import offline 


from die import Die 


# 创建 两 个 D6。 
die 1 = Die() 
die 2 = Die() 


# 搓 几 次 朋 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [| 
for roll num in range(1000): 
© result = die 1.r0oll() + die 2.r011() 
results.append(result) 


# 分 析 结 果 。 
frequencies = [] 


15.4 使 用 Plotly 模拟 掷 山子 ”297 


@ max result = die 1.num sides + die 2.num sides 
@ for value in range(2, max result+1): 
frequency = results.count(value) 
frequencies.append(frequency) 


# 可 视 化 结果 。 
x_values = list(range(2, max_result+1)) 
data = [Bar(x=x values, y=frequencies)] 


@ x axis config = {'title': ' 结 果 '，'dtick': 1} 
y_axis config = {'title': ' 结 果 的 频 举 '} 
my_layout = Layout(title= ' 据 两 个 D6 1000 次 的 结果 '， 
xaxis=x axis config, yaxis=y axis config) 
offline.plot({'data': data, 'layout': my layout}, filename="'d6 d6.html') 


创建 两 个 Die 实例 后 ， 撕 般 子 多 次 ， 并 计算 每 次 的 总 点 数 ( 见 @ )。 可 能 出 现 的 最 大 点 数 为 
两 个 角子 的 最 大 可 能 点 数 之 和 ( 12 ), 这 个 值 存储 在 max_result 中 ( 见 @ )。 可 能 出 现 的 最 小 总 点 
数 为 两 个 骨 子 的 最 小 可 能 点 数 之 和 (2 )。 分析 结 果 时 ,计算 2 到 max_result 的 各 种 点 数 出 现 的 
次 数 ( 见 @ )。( 我 们 原本 可 以 使 用 range(2，13)， 但 这 只 适用 于 两 个 D6。 模 拟 现实 世界 的 情形 
时 ,最 好 编写 可 轻松 模拟 各 种 情形 的 代码 。 前 面 的 代码 让 我 们 能 够 模拟 撕 任 意 两 个 散 子 的 情形 ， 
不 管 这 些 贷 子 有 多 少 面 。) 


创建 图 表 时 ， 在 字典 x _ axis_config 中 使 用 了 dtick 键 ( 见 @ )。 这 项 设置 指定 了 x 轴 显 示 的 
刻度 间距 。 这 里 绘制 的 直方 图 包含 的 条 形 更 多 , Plotly 默认 只 显示 某 些 刻 度 值 ， 而 设置 'dtick': 1 
让 Plotly 显示 每 个 刻度 值 。 另 外 ， 我 们 还 修改 了 图 表 名 称 及 输出 文件 名 。 


运行 这 些 代码 后 ， 你 将 看 到 如 图 15-13 所 示 的 图 表 。 
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图 15-13 ”模拟 同时 掷 两 个 6 面 般 子 1000 次 的 结果 
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这 个 图 表 显 示 了 掷 两 个 D6 时 得 到 的 大 致 结果 。 如 你 所 见 ， 总 点 数 为 2 或 12 的 可 能 性 最 小 ， 
而 总 点 数 为 7 的 可 能 性 最 大 。 这 是 因为 在 下 面 6 种 情况 下 得 到 的 总 点 数 都 为 7: 1 和 6、2 和 5、3 
和 4、4 和 3、5 和 2 以 及 6 和 1。 

15.4.7 ”同时 据 两 个 面 数 不 同 的 般 子 
下 面 来 创建 一 个 6 面 般 子 和 一 个 10 面 骨 子 ， 看 看 同时 掷 这 两 个 仍 子 50 000 次 的 结果 如 何 : 


dice visual.py from plotly.graph objs import Bar, Layout 
from plotly import offline 


from die import Die 


# 创建 一 个 D6 和 一 个 D10。 
die 1 = Die() 
@ die 2 = Die(10) 


# 掷 几 次 股子 并 将 结果 存储 在 一 个 列表 中 。 
results = [| 
for roll num in range(50 000): 
result = die 1.r01ll() + die 2.r011() 
results.append(result) 


# 分 析 结 果 。 
--5170D-- 


# 可 视 化 结果 。 
x values = list(range(2, max result+1)) 
data = [Bar(x=x values, y=frequencies)] 


x axis config = {'title': ' 结 有 果 '，'dtick': 1} 
y_axis config = {'title': ' 结 有 果 的 频 举 '} 
@ my layout = Layout(title=' 搓 一 个 D6 和 一 个 D10 50 000 次 的 结果 '， 
xaxis=x axis config, yaxis=y axis config) 
offline.plot({'data': data, 'layout': my layout}, filename="'d6 d10.html') 


为 创建 D10， 我 们 在 创建 第 二 个 Die 实例 时 传递 了 实 参 10 ( 见 @ ); 修改 了 第 一 个 循环 ， 以 
模拟 找 散 子 50 000 而 不 是 1000 次 ; 还 修改 了 图 表 名 称 和 输出 文件 名 ( 见 @ )。 


图 15-14 显示 了 最 终 的 图 表 。 可 能 性 最 大 的 点 数 不 止 一 个 ， 而 是 有 5 个。 这 是 因为 导致 出 现 
最 小 点 数 和 最 大 点 数 的 组 合 都 只 有 一 种 (1 和 1 以 及 6 和 10 )， 但 面 数 较 小 的 仍 子 限制 了 得 到 中 
间 点 数 的 组 合 数 : 得 到 总 点 数 7、8、9、10 和 11 的 组 合 数 都 是 6 种 。 因 此 ， 这 些 总 点 数 是 最 常 
见 的 结果 ， 它 们 出 现 的 可 能 性 相同 。 
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掷 一 个 D6 和 一 个 D10 50 000 次 的 结果 
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图 15-14 同时 掷 6 面 贷 子 和 10 面 货 子 50 000 次 的 结 


通过 使 用 Plotly 模拟 掷 骨 子 的 结果 ,我们 能 够 非常 自由 地 探索 这 种 现象 。 只 需 几 分 钟 ， 就 可 
模拟 掷 各 种 仍 子 很 多 次 。 


动手 试 一 斌 
练习 15-6: 两 个 D8 编写 一 个 程序 ， 模 拟 同时 搬 两 个 8 面 钥 子 1000 次 的 结果 。 先 
想象 一 下 结果 会 是 什么 样 的 ， 再 运行 这 个 程序 ， 看 看 你 的 直觉 准 不 准 。 逐 渐 增 加 搬 鹏 子 
的 次 数 ， 直 到 系统 不 堪 重 负 为 止 。 
练习 15-7: 同时 搓 三 个 蜗 子 ”同时 据 三 个 D6 时 ， 可 能 得 到 的 最 小 点 数 为 3， 了 最 大 
点 数 为 18。 请 通过 可 视 化 展示 同时 搓 三 个 D6 的 结果 。 
练习 15-8: 将 点 数 相 乘 “同时 搓 两 个 咒 子 时 ， 通 常 将 其 点 数 相 加 。 请 通过 可 视 化 


展示 将 两 个 蜗 子 的 点 数 相 乘 的 结果 。 


练习 15-9: 改 用 列表 解析 为 清晰 起 见 ， 本 节 模 拟 括 鹏 子 的 结果 时 ， 使 用 的 是 较 长 
的 for 循环 。 如 果 你 熟悉 列表 解析 ， 尝 试 将 这 些 程序 中 的 一 个 或 两 个 for 循环 改 为 列表 
解析 。 

练习 15-10: 使 用 两 个 库 尝试 使 用 Matplotlib 通过 可 视 化 来 模拟 搓 朋 子 的 情况 ， 
并 尝试 使 用 Plotly 通过 可 视 化 来 模拟 随机 漫步 的 情况 。 要 完成 这 个 练习 ， 需 要 查看 这 些 
库 的 文档 。 
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15.5 小结 

在 本 章 中 ， 你 学 习 了 : 如 何 生成 数据 集 以 及 如 何 对 其 进行 可 视 化 ; 如 何 使 用 Matplotlib 创建 
简单 的 图 表 ， 以 及 如 何 使 用 散 点 图 来 探索 随机 漫步 过 程 ， 如 何 使 用 Plotly 来 创建 直方 图 ， 以 及 如 
何 使 用 直方 图 来 探索 同时 掷 两 个 面 数 不 同 的 仍 子 的 结果 。 

使 用 代码 生成 数据 集 是 一 种 有 趣 而 强大 的 方式 , 可 用 于 模拟 和 探索 现实 世界 的 各 种 情形 。 完 
成 后 面 的 数据 可 视 化 项 目 时 , 请 注意 可 使 用 代码 模拟 哪些 情形 。 请 研究 新 闻 媒体 中 的 可 视 化 , 看 
看 其 中 是 否 有 图 表 是 以 你 在 这 些 项 目 中 学 到 的 类 似 方式 生成 的 。 

在 第 16 章 中 ， 我 们 将 从 网 上 下 载 数据 ， 并 继续 使 用 Matplotlib 和 Plotly 来 探索 这 些 数据 。 


下 载 数 据 


本 章 将 从 网 上 下 载 数据 , 并 对 其 进行 可 视 化 。 网 上 的 数据 多 得 令 
人 难以 置信 , 大 多 未 经 仔细 检查 。 如 果 能 够 对 这 些 数据 进行 分 析 ， 就 
能 发 现 别 人 没有 发 现 的 规律 和 关联 。 

本 章 将 访问 并 可 视 化 的 数据 以 两 种 常见 格式 存储 :CSV 和 JSON。 
我 们 将 使 用 Python 模块 csv 来 处 理 以 CSV 格式 存储 的 天 气 数据 ， 找 
出 两 个 地 区 在 一 段 时 间 内 的 最 高 温度 和 最 低温 度 。 然 后 ， 使 用 
Matplotlib 根据 下 载 的 数据 创建 一 个 图 表 ， 展 示 两 个 不 同 地 区 的 温度 
变化 : 阿拉 斯 加 州 锡 特 卡 和 加 利 福 尼 亚 州 死 亡 谷 。 然 后 ， 使 用 模块 
json 访问 以 JSON 格式 存储 的 地 震 数 据 ， 并 使 用 Plotly 绘制 一 幅 散 点 图 ， 展 示 这 些 地 震 的 位 
置 和 震级 。 

阅读 本 章 后 ， 你 将 能 够 处 理 各 种 类 型 和 格式 的 数据 集 ， 并 对 如 何 创建 复杂 的 图 表 有 深入 
的 认识 。 要 处 理 各 种 真实 的 数据 集 ， 必 须 能 够 访问 并 可 视 化 各 种 类 型 和 格式 的 在 线 数 据 。 


16.1 CSV 文件 格式 


要 在 文本 文件 中 存储 数据 , 一 个 简单 方式 是 将 数据 作为 一 系列 以 逗号 分 隔 的 值 ( comma-separated 
values ) 写 信 文件。 这 样 的 文件 称 为 CSV 文件 。 例 如 ， 下 面 是 一 行 CSV 格式 的 天 气 数据 : 


"USWO0025333", "SITKA AIRPORT, AK US","2018-01-01","0.45",,"48","38" 


这 是 阿拉 斯 加 州 锡 特 卡 2018 年 1 月 1 日 的 天 气 数据 , 其 中 包含 当天 的 最 高 温度 和 最 低温 度 ， 
还 有 众多 其 他 的 数据 -CSV 文件 对 人 来 说 阅读 起 来 比较 麻烦 ,但 程序 可 轻松 提取 并 处 理 其 中 的 值 ， 
有 助 于 加 快 数据 分 析 过 程 。 


我 们 将 首先 处 理 少量 CSV 格式 的 锡 特 卡 天 气 数 据 ， 这 些 数据 可 在 本 书 的 配套 资源 (ituring.cn/ 
book/2784 ) 中 找到 。 请 将 文件 sitka_ weather 07-2018_simple.csv 复制 到 存储 本 章程 序 的 文件 夹 中 。 
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(下 载 本 书 的 配套 资源 后 ， 就 有 了 这 个 项 目 所 需 的 所 有 文件 。) 


注意 ”该 项 目 使 用 的 天 气 数据 来 自 美 家 海洋 与 大 气管 理 局 ( National Oceanic and Atmospheric 
Administration, NOAA ), 


16.1.1 分 析 CSV 文件 头 

csv 模块 包含 在 Python 标准 库 中 ， 可 用 于 分 析 CSV 文件 中 的 数据 行 ， 让 我 们 能 够 快速 提取 
感 兴趣 的 值 。 先 来 查看 这 个 文件 的 第 一 行 , 其 中 的 一 系列 文件 头 指出 了 后 续 各 行 包含 的 是 什么 样 
的 信息 : 


sitka_highs.py import CSV 


filename = 'data/sitka weather 07-2018 simple.csv" 
@ with open(filename) as f: 
@ reader = csv.reader(f) 
(3) header row = next(reader) 
print(header row) 


导入 模块 csv 后 ,将 要 使 用 的 文件 的 名 称 赋 给 filename。 接 下 来 ， 打开 这 个 文件 ,并 将 返回 
的 文件 对 和 象 赋 给 f( 见 @ ), 然后 , 调用 csv.reader() 并 将 前 面 存储 的 文件 对 象 作 为 实 参 传递 给 它 ， 
从 而 创建 一 个 与 该 文件 相关 联 的 阅读 器 对 象 ( 见 @ )。 这 个 阅读 器 对 象 被 赋 给 了 reader。 

模块 csv 包含 函数 next(), 调用 它 并 传人 阅读 带 对 象 时 , 它 将 返回 文件 中 的 下 一 行 。 在 上 述 
代码 中 ， 只 调用 了 next() 一 次 ， 因 此 得 到 的 是 文件 的 第 一 行 ， 其 中 包含 文件 涉 ( 见 @ )。 将 返回 
的 数据 存储 到 header_row 中 。 如 你 所 见 ，header_row 包含 与 天 气相 关 的 文件 头 ， 指 出 了 每 行 都 
包含 哪些 数据 : 


['STATION', 'NAME', 'DATE', 'PRCP', 'TAVG', 'TMAX', 'TMIN'] 


reader 处 理 文件 中 以 逗号 分 隔 的 第 一 行 数据 ， 并 将 每 项 数据 都 作为 一 个 元 素 存储 在 列表 中 。 
文件 头 STATION 表示 记录 数据 的 气象 站 的 编码 。 这 个 文件 头 的 位 置 表明 ， 每 行 的 第 一 个 值 都 是 气 
象 站 编码 。 文 件 头 NAME 指出 每 行 的 第 二 个 值 都 是 记录 数据 的 气象 站 的 名 称 。 其 他 文件 头 则 指出 
记录 了 哪些 信息 。 当 前 ， 我 们 最 关心 的 是 日 期 (DATE )、 最 高 温度 (TMAX ) 和 最 低温 度 (TMIN )。 
这 是 一 个 简单 的 数据 集 ， 只 包含 降水 量 以 及 与 温度 相关 的 数据 。 你 自己 下 载 天 气 数据 时 ,可 选择 
涵盖 众多 测量 值 ， 如 风速 、 风 向 以 及 详细 的 降水 量 数据 。 


16.1.2 ”打印 文件 头 及 其 位 置 
为 了 让 文件 头 数据 更 容易 理解 ， 将 列表 中 的 每 个 文件 头 及 其 位 置 打印 出 来 : 
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sitka_highs.py -- snip-- 
with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 


© for index, column header in enumerate(header row) 
print(index, column header) 


在 循环 中 ， 对 列表 调用 了 enumerate() ( 见 @ ) 来 获取 每 个 元 素 的 索引 及 其 值 。( 请 注意 ,我 
们 删除 了 代码 行 print(header row) ， 转 而 显示 这 个 更 详细 的 版 本 。) 


输出 如 下 ， 指 出 了 每 个 文件 头 的 索引 : 


0 STATION 
1 NAME 
2 DATE 
3 PRCP 
4 TAVG 
5 TMAX 
6 TMIN 


从 中 可 知 ， 日 期 和 最 高 温度 分 别 存 储 在 第 三 列 和 第 六 列 。 为 研究 这 些 数 据 ， 我 们 将 处 理 
sitka_weather_07-2018_simple.csv 中 的 每 行 数 据 ， 并 提取 其 中 索引 为 2 和 5 的 值 。 


16.1.3 ”提取 并 读 取 数 据 
知道 需要 哪些 列 中 的 数据 后 ， 我 们 来 读 取 一 些 数据 。 首 先 ， 读 取 每 天 的 最 高 温度 : 


sitka_highs.py -- sn1p-- 
with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 


# 从 文件 中 获取 最 高 温度 。 
highs = [] 
for row in reader: 
high = int(row[5]) 
highs.append(high) 


@Q@Oe 


print(highs ) 


创建 一 个 名 为 highs 的 空 列表 ( 见 @ )， 再 遍历 文件 中 余下 的 各 行 ( 见 @ )。 阅 读 器 对 象 从 其 
停留 的 地 方 继续 往 下 读 取 CSV 文件 ， 每 次 都 自动 返回 当前 所 处 位 置 的 下 一 行 。 由 于 已 经 读 取 了 
文件 头 行 ， 这 个 循环 将 从 第 二 行 开始 一 一 从 这 行 开始 包含 的 是 实际 数据 。 每 次 执行 循环 时 ,都 将 
索引 5 处 (TMAX 列 ) 的 数据 附加 到 highs 末尾 ( 见 @ )。 在 文件 中 ， 这 项 数据 是 以 字符 串 格式 存 
储 的 ， 因 此 在 附加 到 highs 末尾 前 ,使 用 函数 int() 将 其 转换 为 数值 格式 ， 以 便 使 用 。 
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highs 现在 存储 的 数据 如 下 : 


[62，58，70，70，67，59，58，62，66，59，56，63，65，58，56，59，64，60，60， 
61，65，65，63，59，64，65，68，66，64，67，65] 


提取 每 天 的 最 高 温度 并 将 其 存储 到 列表 中 之 后 ， 就 可 以 可 视 化 这 些 数据 了 。 


16.1.4 ”绘制 温度 图 表 


为 可 视 化 这 些 温度 数据 ， 首 先 使 用 Matplotlib 创建 一 个 显示 每 日 最 高 温度 的 简单 图 形 ， 如 下 
所 示 : 


sitka_highs.py import CSV 
import matplotlib.pyplot as plt 


ilename = 'data/sitka weather 07-2018 simple.cSsv” 
with open(filename) as f: 
-- Snip 


根据 最 高 温度 绘制 图 形 。 
plt.style.use(l'seaborn') 
fig, ax = plt.subplots() 
@ ax.plot(highs, c='red') 


设置 图 形 的 格式 。 
@ ax.set title("2018 年 7 月 每 日 最 高 温度 " ，fontsize=24) 
@ ax.set xlabel('', fontsize=16) 
ax.Sset ylabel(" 温 度 (F)"，fontsize=16) 
ax.tick params(axis="'both', which="'major', labelsize=16) 


plt.show() 


将 最 高 温度 列表 传 给 plot() ( 见 @ )， 并 传递 c='red' 以便 将 数据 点 绘制 为 红色 。( 这 里 使 用 红 
色 显 示 最 高 温度 , 用 蓝 色 显 示 最 低温 度 。) 接 下 来 , 设置 了 一 些 其 他 的 格式 , 如 名 称 和 字号 ( 见 @ )， 
这 些 都 在 第 15 章 介绍 过 。 鉴 于 还 没有 添加 日 期 ， 因 此 没有 给 x 轴 添 加 标签 , 但 ax.set_xlabel() 
确实 修改 了 字号 ， 让 默认 标签 更 容易 看 清 ( 见 @ )。 图 16-1 显示 了 绘制 的 图 表 : 一 个 简单 的 折线 
图 ， 显 示 了 阿拉 斯 加 州 锡 特 卡 2018 年 7 月 的 每 日 最 高 温度 。 
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rer Figure 1 


2018 年 7 月 每 日 最 高 温度 


温度 (F) 


56 
0 5 10 15 20 25 30 


Cahakakale Ed 


图 16-1 阿拉 斯 加 州 锡 特 卡 2018 年 7 月 每 日 最 高 温度 折线 图 


16.1.5 ”模块 datetime 
下 面 在 图 表 中 添加 日 期 ,使 其 更 有 用 。 在 天 气 数据 文 件 中 ， 第 一 个 日 期 在 第 二 行 : 


"USWOOO25333","SITKA AIRPORT, AK US","2018-07-01","0.25",,"62","50" 


读 取 该 数据 时 ， 获 得 的 是 一 个 字符 串 ， 因 此 需要 想 办 法 将 字符 串 "2018-7-1" 转 换 为 一 个 表示 
相应 日 期 的 对 象 。 为 创建 一 个 表示 2018 年 7 月 1 日 的 对 象 ， 可 使 用 模块 datetime 中 的 方法 
strptime()。 我 们 在 终端 会 话 中 看 看 strptime() 的 工作 原理 : 


>>> from datetime import datetime 

>>> first date = datetime.strptime('2018-07-01', '%Y-%m-%d') 
>>> print(first date) 

2018-07-01 00:00:00 


首先 导入 模块 datetime 中 的 datetime 类 ， 再 调用 方法 strptime()， 并 将 包含 所 需 日 期 的 字 
符 串 作为 第 一 个 实 参 。 第 二 个 实 参 告 诉 Python 如 何 设置 日 期 的 格式 。 在 这 里 ，'%Y-' 让 Python 
将 字符 串 中 第 一 个 连 字 符 前 面 的 部 分 视 为 四 位 的 年 份 ，'%m-' 让 Python 将 第 二 个 连 字符 前 面 的 部 
分 视 为 表示 月 份 的 数 ，'%d' 让 Python 将 字符 串 的 最 后 一 部 分 视 为 月 份 中 的 一 天 (1 ~31 )。 

方法 strptime() 可 接受 各 种 实 参 ， 并 根据 它们 来 决定 如 何 解读 日 期 。 表 16-1 列 出 了 这 样 的 
一 些 实 参 。 
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表 16-1 模块 datetime 中 设置 日 期 和 时 间 格 式 的 实 参 
实 参 含 义 
%A 星期 几 ， 如 Monday 
XB 月 份 名 ， 如 January 
Ym 用 数 表示 的 月 份 (01 ~ 12) 
Xd 用 数 表示 的 月 份 中 的 一 天 (01 ~ 31) 
%Y 四 位 的 年 份 ， 如 2019 
%y 两 位 的 年 份 ， 如 19 
%H 24 小 时 制 的 小 时 数 (00 ~ 23 ) 
%I 12 小 时 制 的 小 时 数 (01 ~ 12 ) 
%p am 或 pm 
YM 分 钟 数 ( 00 ~ 59 ) 
%S 秒 数 ( 00 ~61) 


16.1.6 


sitka_highs.py 


在 图 表 中 添加 日 期 


现在 ， 可 以 通过 提取 日 期 和 最 高 温度 并 将 其 传递 给 plot()， 对 温度 图 形 


行 改 进 


， 如 下 所 示 : 


import CSV 
from datetime import datetime 


import matplotlib.pyplot as plt 


filename = 'data/sitka weather 07-2018 simple.csv' 
with open(filename) as f: 

reader = csv.reader(f) 

header row = next(reader) 


# 从 文件 中 获取 日 期 和 最 高 温度 。 
dates, highs = [], [] 
for row in reader: 
current date = datetime.strptime(row[2], '%Y-%m-%d') 
high = int(row[5]) 
dates.append(current date) 
highs.append(high) 


# 根据 最 高 温度 绘制 图 形 
plt.style.use(l'seaborn') 
fig, ax = plt.subplots() 


ax.plot(dates, hi 


# 设置 图 形 的 格式 
ax.set title("20 
ax.set xlabel(' 


ghs, c='red') 


18 年 7 月 每 日 最 高 温度 "，fontsize=24) 


', fontsize=16) 
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@ fig.autofmt xdate() 
ax.set ylabel(" 温 度 (F)"，fontsize=16) 
ax.tick params(axis="'both', which="'major', labelsize=16) 


plt. show() 


我 们 创建 了 两 个 空 列表 ， 用 于 存储 从 文件 中 提取 的 日 期 和 最 高 温度 ( 见 @ )。 然 后 ， 将 包含 
日 期 信息 的 数据 (row[2] ) 转换 为 datetime 对 象 ( 见 @ )， 并 将 其 附加 到 列表 dates 末尾 。 在 @ 
处 ， 将 日 期 和 最 高 温度 值 传递 给 plot()。 在 @ 处 ， 调 用 fig.autofmt xdate() 来 绘制 倾斜 的 日 期 
标签 ， 以 免 其 彼此 重 徐 。 图 16-2 显示 了 改进 后 的 图 表 。 
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图 16-2 ”现在 图 表 的 x 轴 上 有 日 期 ,含义 更 丰富 


16.1.7 ”涵盖 更 长 的 时 间 
设置 好 图 表 后 ， 我 们 来 添加 更 多 的 数据 ， 生 成 一 幅 更 复杂 的 锡 特 卡 天 气 图 。 请 将 文件 sitka_ 
weather_2018_simple.csv 复制 到 本 音程 序 所 在 的 文件 来， 该 文件 包含 整 年 的 锡 特 卡 天 气 数据 。 
现在 可 创建 覆盖 整 年 的 天 气 图 了 : 


sitka_highs.py  --5S17D-- 

@ filename = 'data/sitka weather 2018 simple.csv’' 
with open(filename) as f: 
-- SNip-- 
# 设置 图 形 的 格式 。 

@ ax.set title("2018 年 每 日 最 高 温度 "，fontsize=24) 
ax.set xlabel('', fontsize=16) 
-- Snip-- 
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这 里 修改 了 文件 名 ， 以 使 用 数据 文件 sitka weather 2018_simple.csv( 见 @ )， 还 修改 了 图 表 
的 标题 ， 以 反映 其 内 容 的 变化 ( 见 @ )。 图 16-3 显示 了 生成 的 图 形 。 


【RE Figure 1 
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图 16-3 ”一 年 的 天 气 数据 


16.1.8 ”再 绘制 一 个 数据 系列 


虽然 改进 后 的 图 表 已 经 显示 了 丰富 的 数据 , 但 是 还 能 再 添加 最 低温 度数 据 , 使 其 更 有 用 。 为 
需要 从 数据 文件 中 提取 最 低温 度 ， 并 将 它们 添加 到 图 表 中 ， 如 下 所 示 : 


此 


> 


sitka_highs” --snip-- 
lows.py filename = 'sitka weather 2018 simple.csv' 
with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 


# 从 文件 中 获取 日 期 、 最 高 温度 和 最 低温 度 。 
© dates, highs, lows = [], [], [] 
for row in reader: 
current date = datetime.strptime(row[2], '%Y-%m-%d') 
high = int(row[5]) 
© low = int(row[6]) 
dates.append(current date) 
highs.append(high) 
lows.append(low) 


# 根据 最 高 温度 和 最 低温 度 绘制 图 形 。 
plt.style.use(l'seaborn') 
fig, ax = plt.subplots() 
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ax.plot(dates, highs, c='red') 
四 ax.plot(dates, lows, c='blue') 


# 设置 图 形 的 格式 。 
@ ax.set title("2018 年 每 日 最 高 温度 "，fontsize=24) 
-- Ship-- 


在 @ 人 处 ,添加 空 列表 lows， 用 于 存储 最 低温 度 。 接 下 来 ， 从 每 行 的 第 七 列 ( row[6] ) 提取 最 
低温 度 并 存储 ( 见 @ )。 在 @ 处 ， 添 加 调用 plot() 的 代码 ， 以 使 用 蓝 色 绘制 最 低温 度 。 最 后 ， 修 
改 标题 ( 见 @ )。 图 16-4 显示 了 这 样 绘制 出 来 的 图 表 。 
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图 16-4 ”在 一 个 图 表 中 包含 两 个 数据 系列 


16.1.9 ”给 图 表 区 域 着 色 

添加 两 个 数据 系列 后 ,就 可 以 知道 每 天 的 温度 范 
过 着 色 来 呈现 每 天 的 温度 范围 。 为 此 ,将 使 用 方法 f 
y 值 系列 ， 并 填充 两 个 y 值 系列 之 间 的 空间 : 


1 


围 了 。 下面 来 给 这 个 图 表 做 最 后 的 修饰 , 通 
11 between()。 它 接受 一 个 x 值 系列 和 两 个 


sitka_highs” --snip-- 
lows.py # 根据 最 低温 度 和 最 高 温度 绘制 图 形 

plt.style.use( "seaborn ') 
fig, ax = plt.subplots() 

@ ax.plot(dates, highs, c='red', alpha=0.5) 
ax.plot(dates, lows, c='blue', alpha=0.5) 

@ ax.fill between(dates, highs, lows, facecolor='blue', alpha=0.1) 
-- Snip-- 
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@ 处 的 实 参 alpha 指定 颜色 的 透明 度 。alpha 值 为 0 表示 完全 透明 , 为 1 (默认 设置 ) 表示 完 
全 不 透明 。 通 过 将 alpha 设置 为 0.5， 可 让 红色 和 蓝 色 折线 的 颜色 看 起 来 更 浅 。 


在 @@ 处 ， 向 fill between() 传 递 一 个 


x 值 系 列 (列表 dates )， 以 及 两 个 y 值 系列 (highs 和 


lows )。 实 参 facecolor 指定 填充 区 域 的 颜色 ， 还 将 alpha 设置 成 了 较 小 的 值 0.1， 让 填充 区 域 将 
两 个 数据 系列 连接 起 来 的 同时 不 分 散 观察 者 的 注意 力 。 图 16-5 显示 了 最 高 温度 和 最 低温 度 之 间 


的 区 域 被 填充 后 的 图 表 。 
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图 16-5 ”给 两 个 数据 集 之 间 的 区 域 着 色 


着 色 让 两 个 数据 集 之 间 的 区 域 变 得 更 显眼 了 。 


16.1.10 ”错误 检查 


我 们 应 该 能 够 使 用 任何 地 方 的 天 气 数据 来 运行 sitka_highs_lows.py 中 的 代码 ,但 有 些 气 象 站 
， 同 ， 有 些 气 ， 未 能 收集 部 分 或 全 部 应 收集 的 数据 。 缺 失 数 


据 可 能 引发 异常 ， 如 果 不 妥善 处 理 ， 


能 导致 程序 崩 演 。 


例如 ,来 看 看 生成 加 利 福 尼 亚 州 死亡 谷 的 温度 图 时 出 现 的 情况 。 请 将 文件 death_valley_2018_ 
simple.csv 复制 到 本 章程 序 所 在 的 文件 夹 。 


首先 通过 编写 代码 来 查看 这 个 数据 文件 包含 的 文件 头 : 


death valley import csv 
highs_ lows.py 


filename = 'data/death valley 2018 simple.csv' 


with open(filename) as f: 
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reader = csv.reader(f) 
header row = next(reader) 


for index, column header in enumerate(header row): 
print(index, column header) 


输出 如 下 : 


STATION 
NAME 
DATE 
PRCP 
TMAX 
TMIN 
TOBS 


mW OPO 


与 前 面 一 样 ， 日 期 也 在 索引 2 处 , 但 最 高 温度 和 最 低温 度 分 别 在 索引 4 和 索引 5 处 ， 因 此 需 
要 修改 代码 中 的 索引 ， 以 反映 这 一 点 。 另 外 ,这 个 气象 站 没有 记录 平均 温度 ， 而 记录 了 TO0BS， 即 
特定 时 点 的 温度 。 


为 演示 缺失 数据 时 将 出 现 的 状况 ， 我 故意 从 这 个 文件 中 删除 了 一 项 温度 数据 。 下 面 来 修改 
sitka_highs_lows.py， 使 用 前 面 所 说 的 索引 来 生成 死亡 谷 的 天 气 图 ， 看 看 将 出 现 什 么 状况 : 


death valley. -- sn1p-- 
highs lows.py filename = 'data/death valley 2018 simple.csv’ 
with open(filename) as 
-- Snip-- 
# 从 文件 中 获取 日 期 、 最 高 温度 和 最 低温 度 。 
dates, highs, lows = [], [], [] 
for row in reader: 
current date = datetime.strptime(row[2], '%Y-%m-%d') 
@ high = int(row[4]) 
low = int(row[5]) 
dates.append(current date) 
-- Snip-- 


十 


在 @ 处 ,修改 索引 ,使 其 对 应 于 这 个 文件 中 TMAX 和 TMIN 的 位 置 。 
运行 这 个 程序 时 出 现 了 错误 ， 如 下 述 输 出 的 最 后 一 行 所 示 : 


Traceback (most recent call last): 
File "death valley highs lows.py", line 15, in <module> 
high = int(row[4]) 
ValueError: invalid literal for int() with base 10: "" 


该 traceback 指出 ，Python 无 法 处 理 其 中 一 天 的 最 高 温度 ， 因 为 无 法 将 空 字符 串 ('' ) 转换 
为 整数 。 我 们 只 要 看 一 下 文件 death_valley 2018 _simple.csv， 就 知道 缺失 了 哪 项 数据 ， 但 这 里 不 
这 样 做 ， 而 是 直接 对 缺失 数据 的 情形 进行 处 理 。 
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为 此 ， 在 从 CSV 文件 中 读 取 值 时 执行 错误 检查 代码 ， 对 可 能 出 现 的 


所 示 : 


异常 进行 处 理 ， 如 下 


death valley. -- s/n1p-- 


highs lows.py filename = 'data/death valley 2018 simple.csv' 
with open(filename) as f: 
-- Snip-- 
for row in reader: 


current date = datetime.strptime(row[2], '%Y-%m-%d') 
try: 
high = int(row[4]) 
low = int(row[5]) 
except ValueError: 
print(f"Missing data for {current date}") 
else: 
dates.append(current date) 
highs.append(high) 
lows .append(low) 


# 根据 最 高 温度 和 最 低温 度 绘制 图 形 。 


-- Snip-- 


# 设置 图 形 的 格式 

@ title = "2018 年 每 日 最 高 温度 和 最 低温 度 \n 美国 加 利 福 尼 亚 州 死亡 谷 " 
ax.set title(title, fontsize=20) 
ax.set xlabel('', fontsize=16) 


=- Snip-- 


对 于 每 一 行 ， 都 尝试 从 中 提取 日 期 、 最 高 温度 和 最 低温 度 ( 见 @ )。 只 要 缺失 其 中 一 项 数 
据 ，Python 就 会 引发 ValueError 异常 。 我 们 这 样 进 行 处 理 : 打印 一 条 错误 消息 ， 指 出 缺失 数 
据 的 日 期 ( 见 @ )。 打 印 错误 消息 后 ， 循 环 将 接着 处 理 下 一 行 。 如 果 获 取 特 定 日 期 的 所 有 数据 


时 没有 发 生 错误 ， 就 运行 else 代码 块 ， 将 数据 附加 到 相应 列表 的 末尾 ( 见 @ )。 这 里 绘图 时 使 


用 的 是 有 关 另 一 个 地 方 的 信息 ， 因 此 修改 标题 以 指出 这 个 地 方 。 因 为 标题 更 长 ， 所 以 我 们 缩小 
了 字号 ( 见 @ )。 


如 果 现 在 运行 death_valley_ highs lows.py， 将 发 现 缺失 数据 的 日 期 只 有 一 个 : 


Missing data for 2018-02-18 00:00:00 


妥善 


图 形 。 


蛙 错 误 后 ， 代 码 能 够 生成 图 形 并 忽略 缺失 数据 的 那天 。 图 16-6 显示 了 绘制 出 的 
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ene Figure 1 
2018 年 每 日 最 高 温度 和 最 低温 度 
美国 加 利 福 尼 亚 州 死亡 谷 


温度 (F) 


oS 人 Re sl Re AA 从 
AR AR AR AR AR Ar A9- 
BD D ?9 BD D D D 


图 16-6 ”死亡 谷 每 天 的 最 高 温度 和 最 低温 度 


将 这 个 图 表 与 锡 特 卡 的 图 表 进 行 比较 可 知 ， 总 体 而 言 , 死亡 谷 比 阿拉 斯 加 东南 部 暖和 ， 这 符 
合 预 期 。 同 时 ， 死 亡 谷 沙漠 中 每 天 的 温差 也 更 大 一 一 从 着 色 区 域 的 高 度 可 以 看 出 这 一 点 。 

你 使 用 的 很 多 数据 集 都 可 能 缺失 数据 、 格 式 不 正确 或 数据 本 身 不 正确 。 对 于 这 样 的 情形 ， 可 
使 用 本 书 前 半 部 分 介绍 的 工具 来 处 理 。 在 这 里 ， 使 用 了 一 个 try-except-else 代码 块 来 处 理 数 据 
缺失 的 问题 。 在 有 些 情况 下 ， 需 要 使 用 continue 来 跳 过 一 些 数据 ， 或 者 使 用 remove() 或 del 将 
已 提取 的 数据 删除 。 只 要 能 进行 精确 而 有 意义 的 可 视 化 ， 采 用 任何 管用 的 方法 都 是 可 以 的 。 


16.1.11 ”自己 动手 下 载 数据 
如 果 你 想 自己 下 载 天 气 数据 ， 可 采取 如 下 步 又。 


(1) 访问 网 站 NOAA Climate Data Online。 在 Discover Data By 部 分 ， 单 击 Search Tool。 在 下 
拉 列 表 Select a Dataset 中 ， 选 择 Daily Summaries。 


(2) 选择 一 个 日 期 范围 , 在 Search For 下 拉 列 表 中 ZIP Codes, 输入 你 感 兴趣 地 区 的 邮政 编码 ， 
再 单 击 Search 按钮 。 


(3) 在 下 一 个 页 面 中 ， 你 将 看 到 指定 地 区 的 地 图 和 相关 信息 。 单 击 地 区 名 下 方 的 View Full 
Details 或 单 击 地 图 再 单 击 Full Details。 


(4) 向 下 滚动 并 单 击 Station List， 以 显示 该 地 区 的 气象 站 ， 再 选择 一 个 气象 站 并 单 击 Add to 
Cart。 虽 然 这 个 网 站 使 用 了 购物 车 图 标 ， 但 提供 的 数据 是 免费 的 。 单 击 右 上 角 的 购物 车 。 


(5) 在 Selectthe Output 中 选择 Custom GHCN-Daily CSV。 确 认 日 期 范围 无 误 后 单 击 Continue。 
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(6) 在 下 一 个 页 面 中 ， 可 选择 要 下 载 的 数据 类 型 。 可 以 只 下 载 一 种 数据 ( 如 气温 )， 也 可 以 下 
载 该 气象 站 提供 的 所 有 数据 。 做 出 选择 后 单 击 Continue。 

(7) 在 最 后 一 个 页 面 ， 你 将 看 到 订单 小 结 。 请 输入 你 的 电子 邮箱 地 址 ， 再 单 击 Submit Order。 
你 将 收 到 一 封 确认 邮件 ， 指 出 收 到 了 你 的 订单 。 几 分 钟 后 ， 你 将 收 到 另 一 封 邮 件 ， 其 中 包含 用 于 
下 载 数 据 的 链接 。 

你 下 载 的 数据 与 本 节 处 理 的 数据 有 类 似 的 结构 , 但 包含 的 文件 头 可 能 不 同 。 然 而 ， 只 要 按 本 
节 介 绍 的 步骤 做 ， 就 能 对 你 感 兴趣 的 数据 进行 可 视 化 。 


动手 试 一 斌 


练习 16-1: 锡 特 卡 的 降雨 量 锡 特 卡 属于 温带 雨林 ， 降 水 量 非常 丰富 。 在 数据 文件 
sitka_ weather 2018_simple.csv 中 , 文件 头 PRCP 表示 的 是 每 日 降水 量 。 请 对 这 列 数据 进 
行 可 视 化 。 如 果 你 想 知道 沙漠 的 降水 量 有 多 低 ， 可 针对 死亡 谷 完成 同样 的 练习 。 

练习 16-2: 比较 锡 特 卡 和 死亡 谷 的 温度 在 有 关 锡 特 卡 和 死亡 谷 的 图 表 中 ， 温 度 刻 
度 反 映 了 数据 范围 的 不 同 。 为 准确 比较 锡 特 卡 和 死亡 谷 的 温度 范围 , 需要 在 y 轴 上 使 用 
相同 的 刻度 。 为 此 ， 请 修改 图 16-5 和 图 16-6 所 示 图 表 的 y 轴 设置 ， 对 锡 特 卡 和 死亡 谷 


的 温度 范围 进行 直接 比较 ( 也 可 对 任何 两 个 地 方 的 温度 范围 进行 比较 )。 

练习 16-3: 旧金山 ”旧金山 的 温度 更 接近 锡 特 卡 还 是 死亡 谷 呢 ? 为 进行 比较 ， 可 下 
载 一 些 有 关 间 金山 的 温度 数据 ， 并 据 此 生成 包含 最 高 温度 和 最 低温 度 的 图 表 。 

练习 16-4: 自动 索引 本 节 以 硬 编码 的 方式 指定 了 TMIN 和 TMAX 列 的 索引 。 请 根据 
文件 头 行 确定 这 些 列 的 索引 ， 让 程序 同时 适用 于 锡 特 卡 和 死 立 谷 。 另 外 ,请 根据 气象 站 
的 名 称 自动 生成 图 表 的 标题 。 

练习 16-5: 探索 ”生成 一 些 图 表 ， 对 你 好 奇 的 任何 地 方 的 其 他 天 气 数 据 进 行 研究 。 


16.2 ”制作 全 球 地 震 散 点 图 : JSON 格式 


在 本 节 中 ”， 你 将 下 载 一 个 数据 集 ， 其 中 记录 了 一 个 月 内 全 球 发 生 的 所 有 地 震 ， 再 制作 一 幅 
散 点 图 来 展示 这 些 地 震 的 位 置 和 震级 。 这 些 数据 是 以 JSON 格式 存储 的 ， 因 此 要 使 用 模块 json 
来 处 理 。Plotly 提供 了 根据 位 置 数据 绘制 地 图 的 工具 ， 适 合 初学 者 使 用 。 你 将 使 用 它 来 进行 可 视 
化 并 指出 全 球 的 地 震 分 布 情况 。 


GD 本 节 为 陶 俊杰 根据 原作 编写 。 一 一 编者 注 
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16.2.1 ”地震 数据 


请 将 文件 eq_data_1_day_mljson 复制 到 存储 本 章程 序 的 文件 夹 中 。 地 震 是 以 里 氏 震 级 度量 
的 ， 而 该 文件 记录 了 【和 截至 写作 本 节 时 ) 最 近 24 小 时 内 全 球 发 生 的 所 有 不 低 于 1 级 的 地 震 。 


16.2.2 ”查看 JSON 数据 
如 果 打 开 文 件 eq_data_ 1_day_ml.json， 你 将 发 现 其 内 容 密密麻麻 ， 难 以 阅读 : 


{"type":"FeatureCollection", "metadata":{"generated":1550361461000,... 
{"type":"Feature", "properties":{"mag":1.2,"place":"11km NNE of Nor... 
{"type":"Feature", "properties":{"mag":4.3,"place":"69km NNW of Ayn... 
{"type":"Feature", "properties":{"mag":3.6,"place":"126km SSE of Co... 
{"type":"Feature", "properties":{"mag":2.1,"place":"21km NNW of Teh... 
{"type":"Feature", "properties":{"mag":4,"place":"57km SSW of Kakto... 


这 些 数据 适合 机 器 而 不 是 人 来 读 取 。 不 过 可 以 看 到 ,， 这 个 文件 包含 一 些 字典 ,还 有 一 些 我 们 
感 兴趣 的 信息 ， 如 震级 和 位 置 。 

模块 json 提供 了 各 种 探索 和 处 理 JSON 数据 的 工具 ， 其 中 一 些 有 助 于 重新 设置 这 个 文件 的 
格式 ， 让 我 们 能 够 更 清楚 地 查看 原始 数据 ， 继 而 决定 如 何以 编程 的 方式 来 处 理 。 

我 们 先 加 载 这 些 数据 并 将 其 以 易于 阅读 的 方式 显示 出 来 。 这 个 数据 文件 很 长 ,因此 不 打印 出 
来 ， 而 是 将 数据 写 入 男 一 个 文件 ， 再 打开 该 文件 并 轻松 地 在 数据 中 导航 : 


eq_explore_ import j son 
data.py 
# 探索 数据 的 结构 。 
filename = 'data/eq data 1 day m1.json’ 
with open(filename) as f: 
@ all eq data = json.1oad(f) 


@ readable file = 'data/readable eq data.json 
with open(readable file, 'w') as f: 
(3 json.dump(all eq data, f, indent=4) 


首先 导入 模块 json， 以 便 恰当 地 加 载 文 件 中 的 数据 ， 并 将 其 存储 到 all_eq_data 中 ( 见 @ )。 
函数 json.10ad() 将 数据 转换 为 Python 能 够 处 理 的 格式 ， 这 里 是 一 个 庞大 的 字典 。 在 @ 处 ,创建 
一 个 文件 ， 以 便 将 这 些 数 据 以 易于 阅读 的 方式 写 入 其 中 。 函 数 json.dump() 接 受 一 个 JSON 数据 
对 象 和 一 个 文件 对 象 ， 并 将 数据 写 和 人 这 个 文件 中 ( 见 @ )。 参数 indent=4 让 dump() 使 用 与 数据 结 
构 匹 配 的 缩 进 量 来 设置 数据 的 格式 。 
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如 果 你 现在 查看 目录 data 并 打开 其 中 的 文件 readable eq_data.json， 将 发 现 其 开头 部 分 像 下 


面 这 样 : 


readable eq_ 
data.json 


的 ， 


震 : 


{ 

"type": "FeatureCollection", 

"metadata": { 
"generated": 1550361461000， 
"url": "https://earthquake.usgs.gov/earthquakes/.../1.0 day.geojson", 
"title": "USGS Magnitude 1.0+ Earthquakes, Past Day", 
"status": 200， 
nap "T7200"; 
"count": 158 

}, 

"features": [ 

-- Snip-- 


这 个 文件 的 开头 是 一 个 键 为 "metadata" 的 片段 ( 见 @ ), 指出 了 这 个 数据 文件 是 什么 时 候 生成 
以 及 能 够 在 网 上 的 什么 地 方 找到 。 它 还 包含 适合 人 类 阅读 的 标题 以 及 文件 中 记录 了 多 少 次 地 
在 过 去 的 24 小 时 内 ， 发生 了 158 次 地 震 。 

这 个 geoJSON 文件 的 结构 适合 存储 基于 位 置 的 数据 。 数据 存储 在 一 个 与 键 "features" 相 关联 


的 列表 中 ( 见 @ )。 这 个 文件 包含 的 是 地 震 数据 ， 因 此 列表 的 每 个 元 素 都 对 应 一 次 地 震 。 这 种 结 
构 可 能 有 点 令 人 迷惑 , 但 很 有 用 , 让 地 质 学 家 能 够 将 有 关 每 次 地 震 的 任意 数量 信息 存储 在 一 个 字 
典 中 ， 再 将 这 些 字 典 放 在 一 个 大 型 列表 中 。 


readable eq_ 


data.json 


我 们 来 看 看 表示 特定 地 震 的 字典 : 


-- Snip-- 
{ 
"type": "Feature", 
"properties": { 
"mag": 0.96， 
-- Snip-- 
"title": "M 1.0 - 8km NE of Aguanga, CA” 

}, 

"geometry": { 
"type": "Point", 
"coordinates": [ 

-116.7941667， 
33.4863333， 
3.22 
] 
]， 
"id": "ci37532978" 
外 


键 "properties" 关 联 到 了 与 特定 地 震 相 关 的 大 量 信 息 ( 见 @ )。 我 们 关心 的 主要 是 与 键 "mag" 


相关 联 的 地 震 震 级 以 及 地 震 的 标题 ， 因 为 后 者 很 好 地 概述 了 地 震 的 震级 和 位 置 ( 见 @ )。 
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键 "geometry" 指 出 了 地 震 发 生 在 什么 地 方 ( 见 @ ), 我 们 需要 根据 这 项 信息 将 地 震 在 散 点 图 
上 标 出 来 。 在 与 键 "coordinates" 相 关联 的 列表 中 ， 可 找到 地 震 发 生 位 置 的 经 度 ( 见 @ ) 和 纬度 
( 见 @ )。 


这 个 文件 的 般 套 层级 比 我 们 编写 的 代码 多 。 如 果 这 让 你 感到 迷惑 ,也 不 用 担心 ，Python 将 替 
你 处 理 大 部 分 复杂 的 工作 。 我 们 每 次 只 会 处 理 一 两 个 谍 套 层级 。 我 们 将 首先 提取 过 去 24 小 时 内 
发 生 的 每 次 地 震 对 应 的 字典 。 


注意 说 到 位 置 时 ， 我们 通常 先 说 纬度 、 再 说 经 度 ， 这 种 习惯 形成 的 原因 可 能 是 人 类 先 发 现 了 
纬度 ， 很 久 后 才 有 经 度 的 概念 。 然 而 ， 很 多 地 质 学 框架 都 先 列 出 经 度 、 后 列 出 纬度 ， 因 
为 这 与 数学 约定 (x,y) 一 致 。 geoJSON 格式 遵循 (经 度 , 纬度 ) 的 约定 , 但 在 使 用 其 他 框架 时 ， 
获悉 其 遵循 的 约定 很 重要 。 


16.2.3 ”创建 地 震 列 表 
首先 ,创建 一 个 列表 ， 其 中 包含 所 有 地 震 的 各 种 信息 : 


eq explore” import json 
data.py 
# 探索 数据 的 结构 。 
filename = 'data/eq data 1 day m1.json’ 
with open(filename) as f: 
all eq data = json.load(f) 


all eq dicts = all eq datal['features'] 
print(len(all eq dicts)) 


我 们 提取 与 键 'features' 相 关联 的 数据 ， 并 将 其 存储 到 all eq_dicts 中 。 我 们 知道 ， 这 个 文 
件 记录 了 158 次 地 震 。 下 面 的 输出 表明 ， 我 们 提取 了 这 个 文件 记录 的 所 有 地 震 : 


158 


， 我 们 编写 的 代码 很 短 。 格 式 良 好 的 文件 readable eq_data.json 包含 超过 6000 行 内 容 ， 
但 只 人 就 可 读 取 所 有 的 数据 并 将 其 存储 到 一 个 Python 列表 中 。 下 面 将 提取 所 有 地 震 
的 震级 。 


16.2.4 提取 震级 


有 了 包含 所 有 地 震 数据 的 列表 后 ,就 可 遍历 这 个 列表 ,从 中 提取 所 需 的 数据 。 下 面 来 提取 每 
次 地 震 的 震级 
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eq _explore” --517D-- 
datia.py all eq dicts = all eq datal'features'] 


@ mags = [] 
for eq dict in all eq dicts: 
@ mag = eq dict['properties' ][ mag "| 
mags.append(mag) 


print(mags[ :10]) 


我 们 创建 了 一 个 空 列表 ， 用 于 存储 地 震 震 级 ， 青 遍历 列表 alL_eq_dicts ( 见 @ )。 每 次 地 震 的 
震级 都 存储 在 相应 字典 的 'properties' 部 分 的 'mag' 键 下 ( 见 @ )。 我 们 依次 将 地 震 震 级 赋 给 变量 
mag， 再 将 这 个 变量 附加 到 列表 mags 末尾 。 


为 确定 提取 的 数据 是 否 正确 ， 打 印 前 10 次 地 震 的 震级 : 


[0296; T2343 30 2 4 L066 2733, M95 138 


接 下 来 ,我 们 将 提取 每 次 地 震 的 位 置信 息 ， 然 后 就 可 以 绘制 地 震 散 点 图 了 。 


16.2.5 ”提取 位 置 数据 


位 置 数据 存储 在 "geometry" 键 下 。 在 "geometry" 键 关联 的 字典 中 ， 有 一 个 "coordinates" 键 ， 
它 关 联 到 一 个 列表 ， 而 列表 中 的 前 两 个 值 为 经 度 和 纬度 。 下 面 演 示 了 如 何 提取 位 置 数 据 : 


eq _explore” --5s/ip-- 
datia.py all eq dicts = all eq datal 'features '] 
mags, titles, lons, lats = [], [], [], [] 
for eq dict in all eq dicts: 
mag = eq dict['properties' ]['mag'] 

© title = eq dict['properties']['title'] 

@ lon = eq dict['geometry']['coordinates'][0] 
lat = eq dict['geometry']['coordinates'][1] 
mags.append(mag) 
titles.append(title) 
lons.append(1lon) 
lats.append(1at) 

print(mags[:10]) 
print(titles[:2] 
print(lons[:5]) 
print(lats[:5]) 


我 们 创建 了 用 于 存储 位 置 标题 的 列表 titles， 来 提取 字典 'properties ' 里 'title' 键 对 应 的 值 
( 见 @ ), 以 及 用 于 存储 经 度 和 纬度 的 列表 。 代码 eq_dict['geometry'] 访 问 与 "geometry" 键 相关 联 
的 字典 ( 见 @ )。 第 二 个 键 ('coordinates' ) 提取 与 "coordinates" 相 关联 的 列表 ， 而 索引 0 提取 
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该 列表 中 的 第 一 个 值 ， 即 地 震 发 生 位 置 的 经 度 。 
打印 前 5 个 经 度 和 纬度 时 ， 输 出 表明 提取 的 数据 是 正确 的 : 


[0.96，1.2，4.3，3.6，2.1，4，1.06，2.3，4.9，1.8] 

['M 1.0 - 8km NE of Aguanga, CA', 'M 1.2 - 11km NNE of North Nenana, Alaska'] 
[-116.7941667，-148.9865，-74. 2343， -161.6801，-118.5316667] 
[33.4863333，64.6673，-12.1025，54.2232，35.3098333] 


有 了 这 些 数 据 ， 就 可 以 绘制 地 震 散 点 图 了 。 


16.2.6 ”绘制 震级 散 点 图 


有 了 前 面 提取 的 数据 ,就 可 以 绘制 可 视 化 图 了 。 首 先 要 实现 一 个 简单 的 震级 散 点 图 ,在 确保 
显示 的 信息 正确 无 误 之 后 ， 我 们 再 将 注意 力 转 向 样式 和 外 观 方面 。 绘 制 初始 散 点 图 的 代码 如 下 : 


eq_world @ import plotly.express as px 
map:py 
fig = px.scatter( 

x=lons, 
y=1ats, 
labels={'x': ' 经 度 '，'y': ' 纬 度 '}， 
range x=[-200，200]， 
range y=[-90,，90]， 
width=800， 
height=800, 
title=' 全 球 地 震 散 点 图 ， 


@ ) 
@ fig.write html('global earthquakes.html') 
@ fig.show() 


首先 ， 导 入 plotly.express， 用 别名 px 表示 。Plotly Express 是 Plotly 的 高 级 接口 ， 简 单 易 
用 ,语法 与 Matplotlib 类 似 ( 见 @ )。 然 后 ， 调 用 px.scatter 孙 数 配置 参数 创建 一 个 fig 实例 ， 
x 轴 为 经 度 [范围 是 [-200，200] (扩大 空间 ， 以 便 完整 显示 东西 经 180° 附 近 的 地 震 散 
点 )]、y 轴 为 纬度 ( 范围 是 [-90，90] )， 设置 散 点 图 显示 的 宽度 和 高 度 均 为 800 像素 ， 并 设置 标 
题 为 “全 球 地 震 散 点 图 ”( 见 @ )。 


只 用 14 行 代码 ， 简 单 的 散 点 图 就 配置 完成 了 ， 这 返回 了 一 个 fig 对 象 。fig.write_html 方 
法 可 以 将 可 视 化 图 保存 为 html 文件 。 在 文件 夹 中 找到 global earthquakes.html 文件 ， 用 浏览 器 打 


开 即 可 ( 见 @ )。 另 外 ， 如 果 使 用 JupyterNotebook， 可 以 直接 使 用 fig.show 方法 直接 在 notebook 
单元 格 显示 散 点 图 ( 见 @ )。 


局 部 效果 如 图 16-7 所 示 。 
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图 16-7 显示 24 小 时 内 所 有 地 震 的 简单 散 点 图 
可 对 这 幅 散 点 图 做 大 量 修改 ， 使 其 更 有 意义 、 更 好 懂 。 下 面 就 来 做 些 这 样 的 修改 。 


16.2.7“ 另 一 种 指定 图 表 数 据 的 方式 


配置 这 个 图 表 前 ， 移 来 看 看 另 一 种 稍微 不 同 的 指定 Plotly 图 表 数 据 的 方式 。 当 前 ， 经 纬度 数 
据 是 手动 配置 的 : 


-- Snip-- 
x=1lons, 
y=1ats, 
labels={'Xx': ' 经 度 '，'y': ' 纬 度 '}， 


-- Snip-- 


这 是 在 Plotly Express 中 给 图 表 定 义 数据 的 最 简单 方式 之 一 ， 但 在 数据 处 理 中 并 不 是 最 佳 的 。 
下 面 是 另 一 种 给 图 表 定 义 数 据 的 等 效 方式 ， 需 要 使 用 pandas 数据 分 析 工 具 。 首 先 创建 一 个 
DataFrame ， 将 需要 的 数据 封装 起 来 : 
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import pandas as pd 


data = pd.DataFrame( 

data=zip(lons，1lats，titles，mags)，Ccolumns=[ 经 度 '， "纬度 "'， "位 置 '， "震级 '] 
) 
data.head() 


然后 ， 参 数 配 置 方 式 可 以 变更 为 : 


-- SNip-- 
data, 
X= "经度 '， 
y=' 纬度 '， 


--Snip-- 


在 这 种 方式 中 ， 所 有 有 关 数 据 的 信息 都 以 键 值 对 的 形式 放 在 一 个 字典 中 。 如 果 在 eq_plotpy 
中 使 用 这 些 代 码 , 生成 的 图 表 是 一 样 的 。 相 比 于 前 一 种 格式 , 这 种 格式 让 我 们 能 够 无 颖 衔接 数据 
分 析 ， 并且 更 轻松 地 进行 定制 。 


16.2.8 ”定制 标记 的 尺寸 


确定 如 何 改进 散 点 图 的 样式 时 , 应 着 重 于 让 要 传达 的 信息 更 清晰 。 当 前 的 散 点 图 显示 了 每 次 
地 震 的 位 置 ， 但 没有 指出 震级 。 我 们 要 让 观察 者 迅速 获悉 最 严重 的 地 震 发 生 在 什么 地 方 。 


为 此 ,根据 地 震 的 震级 设置 其 标记 的 尺寸 : 


eq_world fig = px.scatter( 
map.py data, 
X=' 经 度 '， 
E 纬度 入 
range x=[-200，200]， 
range _y=[-90，90]， 
width=800， 
height=800， 
title=' 全 球 地 震 散 点 图 '， 
Size= 震级 ， 
size max=10, 
) 
fig.write html('global earthquakes.html') 
fig.show() 


©® 


Plotly Express 支持 对 数据 系列 进行 定制 ， 这 些 定制 都 以 参数 表示 。 这 里 使 用 了 size 参数 
来 指定 散 点 图 中 每 个 标记 的 尺寸 ， 我 们 只 需要 将 前 面 data 中 的 "震级 "字段 提供 给 size 参数 即 
可 ( 见 @ )。 另 外 ， 标 记 尺 寸 默认 为 20 像素 ， 还 可 以 通过 size_max=10 将 最 大 显示 尺寸 缩放 到 
10 ( 见 @ )。 
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如 果 运 行 这 些 代码 ， 将 看 到 类 似 于 图 16-8 所 示 的 散 点 图 。 这 上 比 前 面 的 散 点 图 好 多 了 ， 但 还 


有 很 大 的 改进 空间 。 
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图 16-8 ”现在 散 点 图 显示 了 地 震 的 震级 


16.2.9 ”定制 标记 的 颜色 


我 们 还 可 以 定制 标记 的 颜色 , 以 呈现 地 震 的 严重 程度 。 执行 这 些 修改 前 , 将 文件 eq_data_30_ 
day_m1l.json 复制 到 你 的 数据 目录 中 ， 它 包含 30 天 内 的 地 震 数据 。 通 过 使 用 这 个 更 大 的 数据 集 ， 
绘制 出 来 的 地 震 散 点 图 将 有 趣 得 多 。 


下 面 演示 了 如 何 使 用 渐变 来 呈现 地 震 震 级 : 


eq world. 四 filename = 'data/eq data 30 day m1.json’ 
map.py -- Snip-- 
fig = px.scatter( 
data， 
Xs" 经度 
y=" 纬度 '， 
range _Xx=[-200，200]， 
range y=[-90,90]， 
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width=800， 
height=800， 
title= "全球 地 震 散 点 图 '， 
size= ' 震级， 
size _max=10， 
© Color= ' 震 级， 
) 


--5170-- 


首先 修改 文件 名 ， 以 使 用 30 天 的 数据 集 ( 见 @ )。 为 了 让 标记 的 震级 按照 不 同 的 颜色 显示 ， 


只 需要 配置 color= 震级 ' 即 可 。 默 认 的 视觉 映射 图 例 渐 变色 范围 是 从 蓝 到 红 再 到 黄 , 数值 越 小 则 
标记 越 蓝 ， 而 数值 越 大 则 标记 越 黄 〈 见 @ )。 


如 果 现 在 运行 这 个 程序 ， 你 看 到 的 散 点 图 将 漂亮 得 多 。 如 图 16-9 所 示 ， 渐 变 的 颜色 指出 了 
地 震 的 严重 程度 。 通 过 在 散 点 图 上 显示 大 量 的 地 震 ， 可 将 板块 边界 大 致 呈现 出 来 ! 
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图 16-9 ”使 用 颜色 和 尺寸 呈现 震级 的 30 天 地 震 散 点 图 


16.2.10 ”其 他 渐变 


Plotly Express 有 大 量 的 渐变 可 供 选 择 。 要 获悉 有 哪些 渐变 可 供 使 用 ， 请 使 用 文件 名 show_ 
color_ scales.py 保存 下 面 这 个 简短 的 程序 : 
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show color import plotly.express as px 
scales.py 
for key in px.colors.named colorscales(): 
print(key) 


Plotly Express 将 渐变 存储 在 模块 colors 中 。 这 些 渐变 是 在 列表 px.colors.named colorscales() 
中 定义 的 。 下 面 的 输出 列 出 了 可 供 你 使 用 的 所 有 渐变 : 


-- Ship-- 
greys 
hot 
inferno 
jet 
magenta 
magma 

-- Snip-- 


这 些 渐变 其 实 映射 到 一 个 个 配色 列表 ， 使 用 px.colors.diverging.RdYlGn[::-1] 可 以 将 对 应 
颜色 的 配色 列表 反 转 。 


注意 Plotly 除了 有 px.colors.diverging 表示 连续 变量 的 配色 方案 ， 还 有 px.colors.sequential 和 
px.colors.qualitative 表 示 离 散 变量 -随便 挑 一 种 配色 ,例如 px.colors.qualitative.Alphabet， 
你 将 看 到 渐变 是 如 何 定义 的 。 每 个 渐变 都 有 起 始 色 和 终止 色 ， 有 些 渐 变 还 定义 了 一 个 或 
多 个 中 间 色 。Plotly 会 在 这 些 定 义 好 的 颜色 之 间 插 入 颜色 。 


16.2.11 添加 鼠标 指向 时 显示 的 文本 


为 完成 这 幅 散 点 图 的 绘制 , 我 们 将 添加 一 些 说 明 性 文本 , 在 你 将 鼠标 指向 表示 地 震 的 标记 时 
显示 出 来 。 除 了 默认 显示 的 经 度 和 纬度 外 ， 还 将 显示 震级 以 及 地 震 的 大 致 位 置 : 


eq_world fig = px.scatter( 
map.py data, 
X= 经 度 '， 
y= 纬度 ， 
range _Xx=[-200，200]， 
Tange_y=[-90，90]， 
width=800， 
height=800， 
title= ' 全 球 地 震 散 点 图 '， 
Size= 震级， 
size max=10, 
color=' 震 级 '， 
hover_name=' 位 置 '， 
) 
fig.write html('global earthquakes.html') 
fig. show() 
-- Snip-- 
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Plotly Express 的 操作 非常 简单 ， 只 需要 将 hover_name 参数 配置 为 data 的 "位 置 "字段 即 可 。 


太 令 人 震惊 了 ! 通过 编写 大 约 40 行 代 码 ， 我 们 就 绘制 了 一 幅 漂 亮 的 全 球 地 震 活 动 散 点 图 ， 
并 通过 30 天 地 震 数据 大 致 展示 了 地 球 的 板块 结构 。Plotly Express 提供 了 众多 定制 可 视 化 外 观 和 
行为 的 方式 。 使 用 它 提供 的 众多 选项 ， 可 让 图 表 和 散 点 图 准确 地 显示 你 所 需 的 信息 。 


动手 试 一 斌 
练习 16-6: 重 构 在 从 all eq dicts 中 提取 数据 的 循环 中 ， 使 用 了 变量 来 指向 震级 、 
经 度 、 纬 度 和 标题 ， 再 将 这 些 值 分 别 附 加 到 相应 列表 的 末尾 。 这 时 在 清晰 地 演示 如 何 从 
JSON 文件 中 提取 数据 ， 但 并 非 必须 这 样 做 。 你 也 可 以 不 使 用 这 些 临 时 变量 ,而 是 直接 
从 eq dict 中 提取 这 些 值 ， 并 将 其 附加 到 相应 的 列表 末尾。 这 样 做 将 缩短 这 个 循环 的 循 
环 体 ， 使 其 只 包含 4 行 代码 。 
练习 16-7: 自动 生成 标题 本 节 定 义 my layout 时 以 手工 方式 指定 标题 ， 这 意味 着 
每 次 变更 源 文件 时 ， 都 需要 修改 标题 。 你 可 以 不 这 样 做 ， 而 是 使 用 JSON 文件 中 元 数据 
( metadata ) 部 分 的 数据 集 标题 。 为 此 ， 可 提取 这 个 值 ， 将 其 赋 给 一 个 变量 ， 并 在 定义 
my_layout 时 使 用 这 个 变量 来 指定 散 点 图 的 标题 。 
练习 16-8: 最 近 发 生 的 地 震 请 在 本 书 配套 资源 中 找到 关于 最 近 1 小 时 、1 天 、7 天 
和 30 天 内 地 震 信 息 的 0 (截至 本 书 出 版 时 ， 参 见 文件 夹 chapter 16/Excercise16-8 )。 
请 使 用 其 中 一 个 数据 集 一 幅 散 点 图 来 展示 最 近 发 生 的 地 震 。 
练习 16-9 : > ~ 的 配套 资源 中 ， Ge world fires 1 day.csy 的 
文件 ,。 它 包含 了 有 关 全 球 各 地 发 生 的 火灾 信息 , 包括 经 et 站 
使 用 16.1 节 介 绍 的 数据 处 理 技术 以 及 16.2 节 介 绍 的 散 。 点 图 绘制 技术 ， 绘 制 一 幅 散 点 图 
来 展示 全 球 哪些 地 方 发 生 了 火灾 。 
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在 本 章 中 ， 你 学 习 了 : 如 何 使 用 现实 世界 中 的 数据 集 ; 如 何 处 理 CSV 和 JSON 文件 ， 以 及 
如 何 提取 感 兴趣 的 数据 ;如 何 使 用 Matplotlib 来 处 理 以 往 的 天 气 数据 ,包括 如 何 使 用 模块 datetime 16 
和 如 何在 同一 个 图 表 中 绘制 多 个 数据 系列 ; 如 何 使 用 Plotly 绘制 呈现 地 质数 据 的 散 点 图 ; 以 及 如 
何 设置 Plotly 散 点 图 和 图 表 的 样式 。 
有 了 使 用 CSV 和 JSON 文件 的 经 验 后 ， 你 将 能 够 处 理 几 乎 任何 要 分 析 的 数据 。 大 多 数 在 线 
数据 集 能 以 这 两 种 格式 中 的 一 种 或 两 种 下 载 。 熟悉 了 这 两 种 格式 , 再 学 习 使 用 其 他 格式 的 数据 就 
会 更 简单 。 
在 下 一 章 , 你 将 编写 自动 从 网 上 采集 数据 并 对 其 进行 可 视 化 的 程序 。 如 果 你 只 是 将 编程 作为 
业余 爱好 ， 学 会 这 些 技能 可 以 增加 乐趣 ; 如 果 你 有 志 于 成 为 专业 程序 员 ， 就 必须 掌握 这 些 技能 。 


使 用 API 


本 章 介 绍 如 何 编写 独立 的 程序 ,对 获取 的 数据 进行 可 视 化 。 这 个 
程序 将 使 用 Web 应 用 程序 编程 接口 (API ) 自动 请 求 网 站 的 特定 信息 
而 不 是 整个 网 页 ，, 再 对 这 些 信息 进行 可 视 化 。 由 于 这 样 编写 的 程序 始 
终 使 用 最 新 的 数据 进行 可 视 化 ,即便 数据 瞬息 万 变 , 它 呈 现 的 信息 也 
是 最 新 的 。 


17.1 使 用 Web API 


Web API 是 网 站 的 一 部 分 ， 用 于 与 使 用 具体 URL 请 求 特定 信息 的 程序 交互 。 这 种 请 求 称 为 
API 调用 。 请 求 的 数据 将 以 易于 处 理 的 格式 (如 JSON 或 CSV ) 返回 。 依赖 于 外 部 数据 源 的 大 多 
数 应 用 程序 依赖 于 API 调 用， 如 集成 社交 媒体 网 站 的 应 用 程序 。 


17.1.1 Git 和 GitHub 


本 章 的 可 视 化 基于 来 自 GitHub 的 信息 ， 这 是 一 个 让 程序 员 能 够 协作 开发 项 目的 网 站 。 我 们 
将 使 用 GitHub 的 API 来 请 求 有 关 该 网 站 中 Python 项 目的 信息 ， 再 使 用 Plotly 生成 交互 式 可 视 化 
图 表 ， 呈 现 这 些 项 目的 受 欢 迎 程度 。 


GitHub 的 名 字源 自 Git, 后 者 是 一 个 分 布 式 版 本 控制 系统 , 帮助 人 们 管理 为 项 目 所 做 的 工作 ， 
避免 一 个 人 所 做 的 修改 影响 其 他 人 所 做 的 修改 。 在 项 目 中 实现 新 功能 时 ，Git 跟踪 你 对 每 个 文件 
所 做 的 修改 。 确定 代码 可 行 后 , 你 提交 所 做 的 修改 ,而 Git 将 记录 项 目 最 新 的 状态 。 如 果 犯 了 错 ， 
想 撤销 所 做 的 修改 ， 你 可 以 轻松 地 返回 到 以 前 的 任何 可 行 状态 。( 要 更 深入 地 了 解 如 何 使 用 Git 
进行 版 本 控制 ， 请 参阅 附录 D。) GitHub 上 的 项 目 都 存储 在 仓库 中 ， 后 者 包含 与 项 目 相 关联 的 一 
切 : 代码 、 项 目 参与 者 的 信息 、 问 题 或 bug 报告 ， 等 等 。 
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GitHub 用 户 可 以 给 喜欢 的 项 目 加 星 (star ) 以 表示 支持 , 还 可 以 跟踪 自己 可 能 想 使 用 的 项 目 。 
在 本 章 中 ,我 们 将 编写 一 个 程序 ， 自 动 下 载 GitHub 上 星 级 最 高 的 Python 项 目的 信息 ， 并 对 这 些 
信息 进行 可 视 化 。 


17.1.2 ”使 用 API 调用 请 求 数据 


GitHub 的 API 让 你 能 够 通过 API 调用 来 请 求 各 种 信息 。 要 知道 API 调用 是 什么 样 的 ， 请 在 
浏览 器 的 地 址 栏 中 输入 如 下 地 址 并 按 回 车 键 : 


https://api.github.com/search/repositories?q=language:python&sort=stars 


这 个 调用 返回 GitHub 当前 托管 了 多 少 个 Python 项目, 以 及 有 关 最 受 欢 迎 的 Python 仓库 的 信 
息 。 下 面 来 仔细 研究 这 个 调用 。 开 头 的 https://api.github.com/ 将 请 求 发 送 到 GitHub 网 站 中 响 
应 API 调用 的 部 分 ， 接 下 来 的 search/repositories 让 API 搜 索 GitHub 上 的 所 有 仓库 。 


repositories 后 面 的 问号 指出 需要 传递 一 个 实 参 。q 表示 查询 ， 而 等 号 (= ) 让 我 们 能 够 开始 
间 定 查询 。 我 们 使 用 language:python 指出 只 想 获取 主要 语言 为 Python 的 仓库 的 信息 。 最 后 的 
&sort=stars 指定 将 项 目 按 星 级 排序 。 


下 面 显示 了 响应 的 前 几 行 。 


{ 

@ "total count": 3494012， 

@ "incomplete results": false, 

@ "items": [ 

{ 

"id": 21289110， 
"node id": "MDEwO1JlcG9zaXRvcnkyMTI4OTExMA=="， 
"name": "awesome-python", 
"full name": "vinta/awesome-python", 
-- Snip-- 


从 响应 可 知 , 该 URL 并 不 适合 人 工 输入 , 因为 它 采 用 了 适合 程序 处 理 的 格式 。 本 书 编写 期 间 ， 
GitHub 总 共有 3 494 012 个 Python 项 目 ( 见 @ )。 "incomplete results" 的 值 为 false ( 见 @ )， 由 此 
知道 请 求 是 成 功 的 ( 并 非 不 完整 的 )。 倘若 GitHub 无 法 处 理 该 API， 此 处 返回 的 值 将 为 true。 接 下 
来 的 列表 中 显示 了 返回 的 "items"， 其 中 包含 GitHub 上 最 受 欢 迎 的 Python 项 目的 详细 信息 ( 见 @ )。 


17.1.3 ”安装 Requests 


Requests 包 让 Python 程序 能 够 轻松 地 向 网 站 请 求 信息 并 检查 返回 的 响应 。 要 安装 Requests 
可 使 用 pip : 


$ python -m pip install --user requests 
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这 个 命令 让 Python 运行 模块 pip， 并 在 当前 用 户 的 Python 安装 中 添加 Requests 包 。 如 果 你 
运行 程序 或 安装 包 时 使 用 的 是 命令 python3 或 其 他 命令 ， 请 务必 在 这 里 使 用 同样 的 命令 。 


注意 ”如 果 该 命令 在 macOS 系统 上 不 管用 ， 可 以 尝试 删除 标志 --useT 再 次 运行 。 


17.1.4 “处理 API 响应 


下 面 来 编写 一 个 程序 , 它 自动 执行 API 调 用 并 处 理 结果 , 以 找 出 GitHub 上 星 级 最 高 的 Python 
项 目 : 


pyihon  @ import requests 
repos.py 


# 执行 API 调用 并 存储 响应 。 

url = "https://api.github.com/search/repositories?q=language:python&sort=stars’ 
headers = {'Accept': 'application/vnd.github.v3+json'} 

r = requests.get(url, headers=headers) 

print(f"Status code: {r.status code}") 

# 将 API 响应 赋 给 一 个 变量 。 

response dict = r.json() 


9 ooeoe 


# 处 理 结果 。 
print(response dict.keys()) 


在 @ 处 , 导入 模块 requests。 在 @ 处 , 存储 API 调用 的 URL。 最 新 的 GitHub API 版 本 为 第 3 
版 ， 因 此 通过 指定 headers 显 式 地 要 求 使 用 这 个 版 本 的 API ( 见 @ )， 再 使 用 requests 调用 API 
( 见 @ )。 


我 们 调用 get() 并 将 URL 传递 给 它 ， 青 将 响应 对 象 赋 给 变量 r。 响 应 对 象 包含 一 个 名 为 
status_code 的 属性 ,指出 了 请 求 是 否 成 功 ( 状态 码 200 表示 请 求 成 功 ),。 在 @ 处 , 打印 status_code， 
核实 调用 是 否 成 功 。 

这 个 API 返回 JSON 格式 的 信息 ， 因 此 使 用 方法 json() 将 这 些 信息 转换 为 一 个 Python 字典 
( 见 @ )， 并 将 结果 存储 在 response_dict 中 。 


最 后 ， 打 印 response dict 中 的 键 ， 输 出 如 下 : 


Status code: 200 
dict keys(['total count', 'incomplete results', "items ']) 


状态 码 为 200, 由 此 知道 请 求 成 功 了 。 响应 字典 只 包含 三 个 键 : 'total _count'、'incomplete_ 
results' 和 'items'。 下 面 来 看 看 响应 字典 内 部 是 什么 样 的 。 


注意 像 这 样 简单 的 调用 应 该 会 返回 完整 的 结果 集 ， 因 此 完全 可 以 忽略 与 'incomplete results' 
关联 的 值 。 但 在 执行 更 复杂 的 API 调 用 时 ， 应 检查 这 个 值 。 
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17.1.5 “处 理 响 应 字典 


将 API 调用 返回 的 信息 存储 到 字典 后 , 就 可 处 理 其 中 的 数据 了 。 我 们 来 生成 一 些 概述 这 些 信 
息 的 输出 。 这 是 一 种 不 错 的 方式 ， 可 确认 收 到 了 期 望 的 信息 ， 进 而 开始 研究 感 兴趣 的 信息 : 


pyihon_repos.py import requests 


# 执行 API 调用 并 存储 响应 。 
-- Snip-- 


# 将 API 响应 赋 给 一 个 变量 。 
response dict = r.json() 
@ print(f"Total repositories: {response dict['total count']}") 


# 探索 有 关 仓 库 的 信息 。 
@ repo dicts = response dict[ items '] 
print(f"Repositories returned: {len(repo dicts)}") 


# 研究 第 一 个 仓库 。 

repo dict = repo dicts[0] 

print(f"\nKeys: {len(repo dict)}") 

for key in sorted(repo dict.keys()): 
print(key) 


OO 


在 @ 人 处， 打印 与 'total_count' 相 关联 的 值 ， 它 指出 了 GitHub 总 共 包 含 多 少 个 Python 仓库 。 

与 'items ' 关 联 的 值 是 个 列表 ， 其 中 包含 很 多 字典 ， 而 每 个 字典 都 包含 有 关 一 个 Python 仓库 
的 信息 。 在 @ 人 处， 将 这 个 字典 列表 存储 在 repo_dicts 中 。 接 下 来 ， 打印 repo_dicts 的 长 度 ， 以 
获悉 获得 了 多 少 个 仓库 的 信息 Co 

为 更 深入 地 了 人 解 每 个 仓库 的 信息 ,提取 repo_dicts 中 的 第 一 个 字典 ,并 将 其 存储 在 repo_dict 
中 ( 见 @ )。 接 下 来 ,打印 这 个 字典 包含 的 键 数 ， 看 看 其 中 有 多 少 信息 ( 见 @ )。 在 @ 处 ， 打 印 这 
个 字典 的 所 有 键 ， 看 看 其 中 包含 哪些 信息 。 


输出 让 我 们 对 实际 包含 的 数据 有 了 更 清晰 的 认识 : 


Status code: 200 
Total repositories: 3494030 
Repositories returned: 30 


@ Keys: 73 
archive url 
archived 
assignees url 
-- Snip-- 
url 
watchers 
watchers count 
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GitHub 的 API 返 回 有 关 仓 库 的 大 量 信息 : repo_dict 包含 73 个 键 ( 见 @ ), 通过 


些 键 ， 可 大 致知 道 可 提取 有 关 项 目的 哪些 信息 。( 要 准确 地 获悉 API 将 返回 哪些 信息 ， 要 么 阅读 
文档 ， 要 人 么 像 这 里 一 样 使 用 代码 来 查看 。) 


python_repos.py 


ee ee 


下 面 来 提取 repo_dict 中 与 一 些 刍 相 关联 的 值 : 


-5n1p-- 

# 研究 有 关 仓 麻 的 信息 

repo dicts = response dict['items'] 
print(f"Repositories returned: {len(repo dicts)}") 


# 研究 第 一 个 仓库 


repo dict = repo dicts[0]| 

print("\nSelected information about first repository:") 
print(f"Name: {repo_dict[ name ]}") 

print(f"Owner: {repo dict['owner']['login']}") 
print(f"Stars: {repo dict['stargazers count']}") 
print(f"Repository: {repo dict['htm] url']}") 
print(f"Created: {repo dict['created at']}") 
print(f"Updated: {repo dict['updated at']}") 
print(f"Description: {repo dict['description']}") 


这 里 打印 的 值 对 应 于 表示 第 一 个 仓库 的 字典 中 的 很 多 键 。 在 @ 处 ， a a 项 目 


所 有 者 是 由 一 个 字典 表示 的 ， 因 此 @ 处 使 用 键 owner 来 访问 表示 所 有 者 的 字典 ， 再 使 用 键 key 来 
获取 所 有 者 的 登录 名 ,在 @ 处 ,打印 项 目 获 得 了 多 少 个 星 的 评级 ,以 及 该 项 目 GitHub 仓库 的 URL。 


接 下 来 ， 显 示 项 目的 创建 时 间 ( 见 @ ) 和 最 后 一 次 更 新 的 时 间 ( 见 @ )。 最后， 打印 仓库 的 描述 。 


输出 类 


似 于 下 面 这 样 : 


Status code: 200 
Total repositories: 3494032 
Repositories returned: 30 


Selected information about first repository: 

Name: awesome-python 

Owner: vinta 

Stars: 61549 

Repository: https://github.com/vinta/awesome-python 

Created: 2014-06-27T21:00:062 

Updated: 2019-02-17T04:30:00Z 

Description: A curated list of awesome Python frameworks, libraries, software 
and resources 


从 上 述 输出 可 知 ， 在 本 书 编写 期 间 ，GitHub 上 星 级 最 高 的 Python 项 目 为 awesome-python， 


其 所 有 者 为 用 户 vinta， 有 60 000 多 位 GitHub 用 户 给 oe 目 加 星 了 。 我 们 可 以 看 到 这 个 项 目 仓 库 
的 URL， 其 创建 时 间 为 2014 年 6 月 , 有 旦 最近 更 新 了 。 最 后 ,描述 指出 项 目 awesome-python 包含 
一 系列 深 受 欢迎 的 Python 资源 。 
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17.1.6 ”概述 最 受 欢迎 的 仓库 


对 这 些 数据 进行 可 视 化 时 , 我 们 想 涵 盖 多 个 仓库 。 下 面 就 来 编写 一 个 循环 ,打印 API 调 用 返 
回 的 每 个 仓库 的 特定 信息 ， 以 便 能 够 在 可 视 化 中 包含 所 有 这 些 信 息 : 


python_repos.py --5Nip-- 
# 研究 有 关 仓 库 的 信息 
repo dicts = response dict['items'] 
print(f"Repositories returned: {len(repo dicts)}") 


@ print("\nSelected information about each repository:") 
@ for repo dict in repo dicts: 

print(f"\nName: {repo dict['name' ]}") 
print(f"Owner: {repo dict['owner']['login']}") 
print(f"Stars: {repo dict['stargazers count']}") 
print(f"Repository: {repo dict['htm]l url']}") 
print(f"Description: {repo dict['description']}") 


在 @ 处 ， 打 印 了 一 条 说 明 性 消息 。 在 @ 处 ,遍历 repo_dicts 中 的 所 有 字典 。 在 这 个 循环 中 ， 
打印 每 个 项 目的 名 称 、 所 有 者 、 星 级 、 在 GitHub 上 的 URL 以 及 描述 : 


Status code: 200 
Total Tepositories: 3494040 
Repositories returned: 30 


Selected information about each repository: 


ame: awesome-python 

Owner: vinta 

Stars: 61549 

Repository: https://github.com/vinta/awesome-python 

Description: A curated list of awesome Python frameworks, libraries, software 
and resources 


ame: system-design-primer 

Owner: donnemartin 

Stars: 57256 

Repository: https://github.com/donnemartin/system-design-primer 
Description: Learn how to design large-scale systems. Prep for the system 
design interview. Includes Anki flashcards. 

-- Snip-- 


ame: python-patterns 

Owner: faif 

Stars: 19058 

Repository: https://github.com/faif/python-patterns 
Description: A collection of design patterns/idioms in Python 


在 上 述 输出 中 ,， 有 些 有 趣 的 项 目 可 能 值得 一 看 。 但 不 要 在 这 上 面 花 费 太 多 时 间 ， 因 为 即将 创 
的 可 视 化 图 表 能 让 你 更 容易 地 看 清 结果 。 


en 
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17.1.7 监视 API 的 速率 限制 


大 多 数 API 存在 速率 限制 , 也 就 是 说 , 在 特定 时 间 内 可 执行 的 请 求 数 存在 限制 。 要 获悉 是 否 
接近 了 GitHub 的 限制 ， 请 在 浏览 器 中 输入 https://api.github.com/rate_limit， 你 将 看 到 类 似 于 下 面 
的 响应 : 


{ 
"resources": 1{ 
"core": { 
"limit": 60， 
"remaining": 58, 
"reset": 1550385312 
}), 
© "search": { 
@ "limit": 10， 
上 "remaining": 8， 
@ "reset": 1550381772 
-- Snip-- 


我 们 关心 的 信息 是 搜索 API 的 速率 限制 ( 见 @ )。 从 @@ 处 可 知 ， 极 限 为 每 分 钟 10 个 请 求 ， 而 
在 当前 分 钟 内 ， 还 可 执行 8 个 请 求 ( 见 @ )。reset 值 指 的 是 配额 将 重 置 的 Unix 时 间或 新 纪元 时 
间 (1970 年 1 月 1 日 午夜 后 多 少 秒 ) ( 见 @ )。 用 完 配 额 后 ,你 将 收 到 一 条 简单 的 响应 ,由 此 知道 
已 到 达 API 极 限 。 到 达 极 限 后 ， 必 须 等 待 配额 重 置 。 


注意 很 多 API 要 求 注册 获得 API 密 钥 后 才能 执行 API 调用。 本 书 编 写 期 间 ，GitEHub 没有 这 样 
的 要 求 ， 但 获得 API 密 钥 后 ， 配 额 将 高 得 多 。 


17.2 ”使 用 Plotly 可 视 化 仓库 


有 了 一 些 有 趣 的 数据 后 ， 我 们 来 进行 可 视 化 ,呈现 GitHub 上 Python 项 目的 受 欢迎 程度 。 我 
们 将 创建 一 个 交互 式 条 形 图 : 条 形 的 高 度 表 示 项 目 获 得 了 多 少 颗 星 。 单 击 条 形 将 带 你 进入 项 目 在 
GitHub 上 的 主页 。 请 复制 前 面 编写 的 python_repos.py， 并 将 副本 修改 成 下 面 这 样 : 


python_repos_ 
visual.py 


import Teq 


@ from plot 
from plot 


@ # 执行 API 


uests 


y.graph objs import Bar 
y import offline 


调用 并 存储 响应 。 


url = 'https://api.github.com/search/repositories?q=language:python&sort=stars 
headers = {'Accept': 'application/vnd.github.v3+json'} 

r = requests.get(url, headers=headers) 

print(f"Status code: {r.status code}") 
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# 处 理 结果 。 
response dict = r.json() 
repo dicts = response dict['items'] 
@ repo names, stars = [], [] 
for repo dict in repo dicts: 
repo_names.append(repo dict[ name ']) 
stars.append(repo dict['stargazers count']) 


# 可 视 化 。 
@ data = [{ 
‘type': 'bar', 
'x': Tepo_names， 
'y': stars, 
}] 
© my layout = { 
'title': 'GitHub 上 最 受 欢迎 的 Python 项 目 '， 
'xaxis': {'title': 'Repository'}, 
'yaxis': {'title': 'Stars'}, 
} 


fig = {'data': data, 'layout': my_ layout} 
offline.plot(fig, filename='python repos.html') 


在 @ 处 ， 导 入 Plotly 中 的 Bar 类 和 模块 offline。 像 第 15 章 的 绘制 直方 图 项 目 中 定义 列表 data 
那样 ， 这 里 也 使 用 字典 来 定义 布局 ， 因 此 不 需要 导入 Layout 类 。 这 里 也 打印 API 响应 的 状态 ， 
以 便 知 道 是 否 出 现 了 问题 ( 见 @ )。 现 在 不 是 探索 阶段 ， 早 已 确定 了 所 需 的 数据 是 存在 的 ， 因 此 
删除 部 分 处 理 API 响应 的 代码 。 

接 下 来 ， 创 建 两 个 空 列表 ， 用 于 存储 要 在 图 表 中 呈现 的 数据 ( 见 @ )。 我 们 需要 每 个 项 目的 
名 称 , 用 于 给 条 形 添加 标签 , 还 需要 知道 项 目 获 得 了 多 少 个 星 , 用 于 指定 条 形 的 高 度 。 在 循环 中 ， 
将 每 个 项 目的 名 称 和 星 级 分 别 附 加 到 这 两 个 列表 未 尾 。 

然后 ， 定 义 列表 data ( 见 @ )。 它 像 第 16 章 的 列表 data 一 样 包 含 一 个 字典 ， 指 定 了 图 表 的 
类 型 ， 并 提供 了 x 值 和 y 值 : x 值 为 项 目 名 称 ， 7 值 为 项 目 获得 了 多 少 个 星 。 

在 @ 处 ,使 用 字典 定义 图 表 的 布局 。 这 里 没有 创建 Layout 实例 ， 而 是 创建 了 一 个 包含 布局 
规范 的 字典 ， 并 在 其 中 指定 了 图 表 的 名 称 以 及 每 个 坐标 轴 的 标签 。 

生成 的 图 表 如 图 17-1 所 示 。 从 中 可 知 ， 前 几 个 项 目的 受 欢 迎 程度 比 其 他 项 目 高 得 多 ， 但 所 
有 这 些 项 目 在 Python 生态 系统 中 都 很 重要 。 
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图 17-1 GitHub 上 最 受 欢 迎 的 Python 项目 


17.2.1 改进 Plotly 图 表 


下 面 来 改进 这 个 图 表 的 样式 。 第 16 章 介绍 过 ， 可 在 data 和 my_layout 中 以 键 值 对 的 形式 指 
定 各 种 样式 。 


通过 修改 data， 可 定制 条 形 。 下 面 是 修改 后 的 data， 给 条 形 指定 了 颜色 和 边框 : 


十 


pyihon_repos  --5170-- 
visualpy data = [{ 

type : 'bar', 

'x': Tepo_names， 

'y': stars, 

'marker': { 
'color': 'rgb(60, 100, 150)', 
"line': {'width': 1.5, 'color': 'rgb(25, 25, 25)'} 

} 

'opacity': 0.6 

}] 


-- Snip-- 


marker 设置 影响 条 形 设 计 。 我 们 给 条 形 指定 了 一 种 自 定 义 的 蓝 色 ， 加 上 了 宽 1.5 像素 的 深 灰 
色 轮 廓 ， 还 将 条 形 的 不 透明 度 设置 为 06， 以 免 图 表 过 于 巷 眼 


下 面 来 修改 my_layout: 
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Pyihon_repos --5/nip-- 
visualpy My layout = { 
'title': 'GitHub 上 最 受 欢 迎 的 Python 项 目 '， 
© 'titlefont': {'size': 28}, 
© 'xaxis': { 
'title': “Repository ， 
'titlefont': {'size': 24}, 
'tickfont': {'size': 14}, 


}， 
@ ‘yaxis': { 
'title': 'Stars', 
'titlefont': {'size': 24}, 
'tickfont': {'size': 14}, 
}， 
} 
-- SNip-- 


使 用 键 'titlefont ' 指 定 图 表 名 称 的 字号 ( 见 @ )。 在 字典 'xaxis' 中 ， 添 加 指定 x 轴 标签 字 
的 设置 ('titlefont' ) 和 刻度 标签 字号 的 设置 ( 'tickfont' ) ( 见 @ )。 由 于 这 站 
中 ， 还 可 以 使 用 相应 的 键 指定 坐标 轴 标 签 和 刻度 标签 的 颜色 和 字体 。 在 旧 处 ， 给 》 轴 指定 类 似 的 


设置 。 
重新 设置 样式 后 的 图 表 如 图 17-2 所 示 。 
sooo file:///Users/eric/pcc_2e/chapter 17/python_repos. html © Ooo. 转 
E Q 二 匣 已 全 一 三 团 
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17.2.2 ”添加 自 定义 工具 提示 


在 Plotly 中 ,将 鼠标 指向 条 形 将 显示 其 表示 的 信息 。 这 通常 称 为 工具 提示 。 在 本 例 中 ， 当 前 
显示 的 是 项 目 获得 了 多 少 个 星 。 下 面 来 创建 自 定义 工具 提示 ， 以 显示 项 目的 描述 和 所 有 者 。 


为 生成 这 样 的 工具 提示 ， 需 要 再 提取 一 些 信息 并 修改 对 象 data: 


pyihon_repos  --5170-- 
visualpy 共处 理 结果 
response dict = r.json() 
repo dicts = response dict['items'] 
@ repo names, stars, labels = [], [], [] 

for repo dict in repo dicts: 
repo names.append(repo dict[ name ']) 
stars.append(repo dict['stargazers count ']) 


@ owner = repo dict['owner' |]['login'] 
description = repo dict['description'] 

@ label = f"{owner}<br />{description}" 
labels.append(1label) 


# 可 视 化 
data = [{ 
'type': 'bar', 
'x': repo names, 
'y': stars, 
@ 'hovertext': labels, 
'marker': { 
'color': 'rgb(60, 100, 150)', 
'line': {'width': 1.5, 'color': 'rgb(25, 25, 25)'} 
}, 
'opacity': 0.6， 
}] 


-- Snip-- 


首先 新 建 一 个 空 列表 1abels ， 用 于 存储 要 给 各 个 项 目 显 示 的 文本 ( 见 @ )。 在 处 理 数 据 的 
循环 中 ， 提 取 每 个 项 目的 所 有 者 和 描述 ( 见 @ )。Plotly 允许 在 文本 元 素 中 使 用 HTML 代码 ， 
此 在 创建 由 项 目 所 有 者 和 描述 组 成 的 字符 串 时 ， 我 们 能 够 在 这 两 部 分 之 间 添 加 换行 符 (<br /> ) 


( 见 @ )。 然 后， 将 这 个 字符 串 附 加 到 列表 labels 末尾 。 


在 列表 data 包含 的 字典 中 ， 添 加 了 键 'hovertext' ， 并 将 与 之 关联 的 值 指定 为 刚 创建 的 列表 


( 见 @ )。Plotly 创建 每 个 条 形 时 ,将 提取 这 个 列表 中 的 文本 ,并 在 观察 者 将 鼠标 指向 条 形 


这 样 修改 后 ， 生 成 的 图 表 如 图 17-3 所 示 。 


时 显示 。 
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图 17-3 ”将 鼠标 指向 条 形 时 ， 将 显示 项 目的 描述 和 所 有 者 


17.2.3 在 图 表 中 添加 可 单 击 的 链接 


Plotly 允许 在 文本 元 素 中 使 用 HIML， 让 你 能 够 轻松 地 在 图 表 中 添加 链接 。 下 面 将 * 轴 标签 作 
为 链接 ， 让 观察 者 能 够 访问 项 目 在 GitHub 上 的 主页 。 为 此 ， 需 要 提取 URL 并 用 其 生成 x 轴 标签 : 


Pyihon_repos  --517D-- 
visualpy # 处 理 结果 。 
response dict = r.json() 
repo dicts = response dict['i 
@ repo links, stars, labels = [ 
for repo dict in repo dicts: 
repo name = repo dict['name'] 
@ Tepo_uT1 = repo dict['html url'] 
@ repo_ link = f"<a href='{repo_ url}'>{repo_name}</a>" 
repo_links.append(repo_link) 


Ss"] 
[], [] 


tem 
]， 


stars.append(repo dict['stargazers count']) 
-- Snip-- 


# 可 视 化 。 
data = [{ 
‘type': 'bar', 
@ 'x': repo links, 
SS 
--517]-- 
}] 


-- Snip-- 


这 里 修改 了 列表 的 名 称 ( 从 repo_names 改 为 repo_links )， 更 准确 地 指出 了 要 组 合 的 信息 
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( 见 @ )。 接 下 来 ， 从 repo dict 中 提取 项 目的 URL， 并 将 其 赋 给 临时 变量 repo_url ( 见 @ ), 在 
处， 创建 一 个 指向 项 目的 链接 ， 为 此 使 用 了 _HTML 标记 <a>， 其 格式 为 <a href='URL'>link 
text</a>。 然 后 ， 将 这 个 链接 附加 到 列表 repo_links 末尾 。 


在 @ 处 ,将 这 个 列表 用 作 图 表 的 x 值 。 生 成 的 图 表 与 前 面相 同 ,但 观察 者 可 单 击 图 表 底 端的 
项 目 名 ， 以 访问 项 目 在 GitHub 上 的 主页 。 至 此 ， 我 们 对 API 获取 的 数据 生成 了 可 视 化 图 表 一 一 
它 是 交互 性 的 ， 包 含 丰 富 的 信息 ! 


17.2.4 深入 了 解 Plotly 和 GitHub API 


要 深入 地 了 解 如 何 生成 Plotly 图 表 , 有 两 个 不 错 的 地 方 可 以 查看 。 第 一 个 是 Plotly User Guide 
in Python。 通 过 研究 该 资源 ， 可 更 深入 地 了 解 Plotly 是 如 何 使 用 数据 来 生成 可 视 化 图 表 的 ， 以 及 
它 采 取 这 种 做 法 的 原因 。 

第 二 个 不 错 的 资源 是 Plotly 网 站 中 的 Python Figure Reference， 其 中 列 出 了 可 用 来 配置 Plotly 
可 视 化 的 所 有 设置 。 这 里 还 列 出 了 所 有 的 图 表 类 型 ， 以 及 在 各 个 配置 选项 中 可 设置 的 属性 。 

要 更 深入 地 了 解 GitHub API， 可 参阅 其 文档 。 通 过 阅读 文档 ， 你 可 以 知道 如 何 从 GitHub 提 
取 各 种 信息 。 如 果 有 GitHub 账户 ， 除 了 向 公众 提供 的 有 关 仓 库 的 信息 外 ， 你 还 可 以 提取 有 关 自 
己 的 信息 。 


17.3 Hacker News API 


为 探索 如 何 使 用 其 他 网 站 的 API 调 用 ， 我们 来 看 看 Hacker News。 在 Hacker News 网 站 ， 用 
户 分 享 编程 和 技术 方面 的 文章 ， 并 就 这 些 文章 展开 积极 的 讨论 。Hacker News 的 API 让 你 能 够 访 
问 有 关 该 网 站 所 有 文章 和 评论 的 信息 ， 且 不 要 求 通 过 注册 获得 密 钥 。 


下 面 的 调用 返回 本 书 编写 期 间 最 热门 的 文章 的 信息 : 


局 


https://hacker-news.firepaseio.Com/VvO/item/19155826.json 


如 果 在 浏览 右 中 输入 这 个 URL， 将 发 现 响应 位 于 一 对 花 括 号 内 ， 表 明 这 是 一 个 字典 。 如 果 
不 改进 格式 , 这 样 的 响应 难以 阅读 。 下 面 像 第 16 章 的 地 震 地 图 项 目 那样 ， 通 过 方法 json.dump() 
来 运行 这 个 URL， 以 便 对 返回 的 信息 进行 探索 : 


hn_arficle.py import requests 
import json 


# 执行 API 调用 并 存储 响应 。 

url = "https://hacker-news.firebaseio.com/vO/item/19155826.json’ 
r = requests.get(url) 

print(f"Status code: {r.status code}") 
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# 探索 数据 的 结构 。 

response dict = r.json() 

readable file = 'data/readable hn data.json' 

with open(readable file, 'w') as f: 
json.dump(response dict, f, indent=4) 


这 里 的 所 有 代码 都 在 前 两 章 使 用 过 ,你 应 该 不 会 感到 卫生。 输出 是 一 个 字典 ,其 中 包含 有 关 
ID 为 19155826 的 文章 的 信息 : 


readable hn_ { 
data.json "by": "jimktrains2", 
© "descendants": 220， 
"id": 19155826， 
29 :kids": 
19156572， 
19158857， 
-- Snip-- 
]， 
"score": 722， 
"time": 1550085414， 


3 "title": "Nasa's Mars Rover Opportunity Concludes a 15-Year Mission", 
"type": "story", 
Q "url": "https://www.nytimes.com/.../mars-opportunity-rover-dead.html" 
} 


这 个 字典 包含 很 多 键 。 与 键 'descendants' 相 关联 的 值 是 文章 被 评论 的 次 数 ( 见 @ )。 与 键 
'kids ' 相 关联 的 值 包含 文章 所 有 评论 的 ID ( 见 @ )。 每 个 评论 本 身 也 可 能 有 评论 ， 因 此 文章 的 后 
代 (descendant ) 数量 可 能 比 其 'kids ' 的 数量 多 。 这 个 字典 中 还 包含 当前 文章 的 标题 ( 见 @ ) 和 
URL ( 见 @ )。 


下 面 的 URL 返回 一 个 列表 ， 其 中 包含 Hacker News 上 当前 排名 靠 前 的 文章 的 ID: 


se hg 


ttps://hacker-news.firebaseio.com/vo/topstories.json 


通过 使 用 这 个 调用 , 可 获悉 当前 有 哪些 文章 位 于 主页 ,再 生成 一 系列 类 似 于 前 面 的 API 调 用 。 
通过 使 用 这 种 方法 ， 可 概述 当前 位 于 Hacker News 主页 的 每 篇 文章 : 


hn_submissions.py from operator import itemgetter 
import requests 


# 执行 API 调用 并 存储 响应 。 

@ url = 'https://hacker-news.firebaseio.com/vo/topstories.json’ 
r = requests.get(url) 
print(f"Status code: {r.status code}") 


# 处 理 有 关 每 篇 文章 的 信息 。 
@ submission ids = r.json() 
@ submission dicts = [] 
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字 


for submission id in submission ids[ :30]: 
# 对 于 每 篇 文章 ， 都 执行 一 个 API 调用 。 


Q@ url = f"https://hacker-news.firebaseio.com/voO/item/{submission id}.json" 


r = requests.get(url) 
print(f"id: {submission id}\tstatus: {r.status code}") 
response dict = r.json() 


# 对 于 每 篇 文章 ， 都 创建 一 个 字典 。 
© submission dict = { 
‘title': response dict['title'], 


‘hn_link': f"http://news.ycombinator.com/item?id={submission id}", 


'comments': response dict['descendants'], 


} 


© submission dicts.append(submission dict) 


@ submission dicts = sorted(submission dicts, key=itemgetter('comments'), 


reverse=True) 


@ for submission dict in submission dicts: 
print(f"\nTitle: {submission dict['title']}") 
print(f"Discussion link: {submission dict['hn link']}") 
print(f"Comments: {submission dict['comments']}") 


首先 ， 执 行 一 个 API 调用， 并 打印 响应 的 状态 ( 见 @ )。 这 个 API 调 用 返回 一 个 列表 ， 其 中 
包含 Hacker News 上 当前 最 热门 的 500 篇 文 草 的 ID。 接 下 来 ， 将 响应 对 象 转换 为 一 个 Python 列 
表 ( 见 @ ), 并 将 其 存储 在 submission_ids 中 。 后面 将 使 用 这 些 ID 来 创建 一 系列 字典 ,其 中 每 个 


典 都 存储 了 一 篇 文章 的 信息 。 


在 @ 处 , 创建 一 个 名 为 submission dicts 的 空 列表 ， 用 于 存储 前 面 所 说 的 字典 。 接 下 来 ,， 遍 
历 前 30 篇 文章 的 ID。 对 于 每 篇 文章 ,都 执行 一 个 API 调 用 , 其 中 的 URL 包含 supmission_id 的 


当前 值 ( 见 @ )。 我 们 打印 请 求 的 状态 和 文章 ID， 以 便 知道 请 求 是 否 成 功 。 


论 


次 


在 @ 处 ,为 当前 处 理 的 文章 创建 一 个 字典 ， 并 在 其 中 存储 文章 的 标题 、 讨 论 页 面 的 链接 和 记 
数 。 然 后 ， 将 submission dict 附加 到 submission dicts 末尾 ( 见 @ )。 
Hacker News 上 的 文章 是 根据 总 体 得 分 排名 的 ， 而 总 体 得 分 取决 于 很 多 因素 ， 包 含 被 推荐 的 
数 、 评 论 数 和 发 表 时间 。 我 们 要 根据 评论 数 对 字典 列表 submission dicts 进行 排序 ,为 此 使 用 


了 模块 operator 中 的 函数 itemgetter() ( 见 @ )。 我们 向 这 个 函数 传递 了 键 'comments' ， 因 此 它 
该 列表 的 每 个 字典 中 提取 与 键 'comments' 关 联 的 值 。 这 样 ， 函 数 sorted() 将 根据 这 个 值 对 列表 


从 
进 


评 


行 排序 。 我 们 将 列表 按 降 序 排列 ， 即 评论 最 多 的 文章 位 于 最 前 面 。 


对 列表 排序 后 遍历 它 ( 见 @ )， 并 打印 每 篇 热门 文章 的 三 项 信息 : 


论 数 : 


标题 、 讨 论 页 面 的 链接 和 


Status code: 200 

id: 19155826 status: 200 
id: 19180181 status: 200 
id: 19181473 status: 200 
-- Snip-- 
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Title: Nasa's Mars Rover Opportunity Concludes a 15-Year Mission 
Discussion link: http://news.ycombinator.com/item?id=19155826 
Comments: 220 


Title: Ask HN: Is 让 practical to create a software-controlled model rocket? 
Discussion link: http://news.ycombinator.com/item?id=19180181 
Comments: 72 


Title: Making My Own USB Keyboard from Scratch 

Discussion link: http://news.ycombinator.com/item?id=19181473 
Comments: 62 

-- Snip-- 


无 论 使 用 哪个 API 来 访问 和 分 析 信 息 , 流程 都 与 此 类 似 。 有 了 这 些 数 据 后 , 就 可 进行 可 视 化 ， 
指出 最 近 哪 些 文章 引发 了 最 激烈 的 讨论 。 基于 这 种 方式 , 应 用 程序 可 以 为 用 户 提供 网 站 ( 如 Hacker 
News ) 的 定制 化 阅读 体验 。 要 深入 了 解 通过 Hacker News API 可 访问 哪些 信息 , 请 参阅 其 文档 页 面 。 


2 
练习 17-1: 其 他 语言 修改 python repos.py 中 的 API 调 用 ,使 其 在 生成 的 图 表 中 显 
示 其 他 语言 最 受 欢 迎 的 项 目 。 请 尝试 语言 JavaScript、Ruby、C、Java、Perl、Haskell 和 Go。 
练习 17-2: 最 活跃 的 讨论 使 用 hn submissions.py 中 的 数据 ,创建 一 个 条 形 图 ， 
显示 Hacker News 上 当前 最 活跃 的 讨论 。 条 形 的 高 度 应 对 应 于 文章 的 评论 数 。 条 形 的 标 
签 应 包含 文章 的 标题 ， 并 且 充 当 到 文章 讨论 页 面 的 链接 。 


练习 17-3: 测试 python_ repos.py 在 python repos.py 中 ， 我 们 打印 了 status code 
的 值 ， 以 核实 API 调 用 是 否 成 功 。 请 编写 一 个 名 为 test_python repos.py 的 程序 ， 它 使 用 
单元 测试 来 断言 status_code 的 值 为 200。 想 想 还 可 做 出 哪些 断言 , 如 返回 的 条 目 (item ) 
数 符合 预期 ， 仓 库 总 数 超过 特定 的 值 ， 等 等 。 


练习 17-4: 进一步 探索 ”查看 Plotly 以 及 GitHub API 或 Hacker News API 的 文档 ， 
再 根据 从 中 获得 的 信息 来 定制 本 节 绘 制 的 图 表 的 样式 ， 或 者 提取 并 可 视 化 其 他 数据 。 


17.4 小结 多量 


在 本 章 中 , 你 学 习 了 : 如 何 使 用 API 来 编写 独立 的 程序 , 以 自动 采集 所 需 的 数据 并 对 其 进行 
可 视 化 ;使 用 GitHub API 来 探索 GitHub 上 星 级 最 高 的 Python 项 目 , 还 大 致 地 了 解 了 Hacker News 
API; 如 何 使 用 Requests 包 来 自动 执行 GitHub API 调 用， 以 及 如 何 处 理 调用 的 结果 。 本 章 还 简要 
介绍 了 一 些 Plotly 设置 ， 可 用 其 进一步 定制 生成 的 图 表 的 外 观 。 


在 本 书 的 最 后 一 个 项 目 中 ,我 们 将 使 用 Django 来 创建 一 个 Web 应 用 程序 。 


项 目 3 Web 应 用 程序 


从 Django 入 手 


在 幕后 ， 当 今 的 网 站 实际 上 都 是 富 应 用 程序 (rich application )， 
就 像 成 熟 的 桌面 应 用 程序 一 样 。Python 提供 了 一 组 开发 Web 应 用 程 
序 的 卓越 工具 。Django 是 一 个 Web 框架 ， 即 一 套 旨 在 帮助 开发 交互 
式 网 站 的 工具 。 本 章 将 介绍 如 何 使 用 Django 来 开发 一 个 名 为 “学 习 
笔记 ”的 项 目 , 这 是 一 个 在 线 日 志 系 统 ， 让 你 能 够 记录 学 习 到 的 有 关 
特定 主题 的 知识 。 


我 们 将 为 这 个 项 目 制定 规范 ， 然 后 为 应 用 程序 使 用 的 数据 定义 模型 。 我 们 将 使 用 Django 的 
管理 系统 来 输入 一 些 初始 数据 ,青学 习 编写 视图 和 模板 ,让 Django 能 够 为 我 们 的 网 站 创建 页 面 。 

Django 能 够 响应 页 面 请 求 ， 还 让 你 能 够 更 轻松 地 读 写 数据 库 、 管 理 用 户 ， 等 等 。 第 19 章 和 
第 20 章 将 改进 “学 习 笔 记 ” 项 目 ， 再 将 其 部 署 到 活动 的 服务 器 ， 让 你 和 朋友 都 能 够 使 用 它 。 


18.1 建立 项 目 


建立 项 目 时 , 首先 需要 以 规范 的 方式 对 项 目 进行 描述 , 再 建立 虚拟 环境 , 以 便 在 其 中 创建 项 目 。 


18.1.1 制定 规范 


完整 的 规范 详细 说 明了 项 目的 目标 ， 阐 述 了 项 目的 功能 ， 并 讨论 了 项 目的 外 观 和 用 户 界 面 。 

与 任何 良好 的 项 目 规 划 和 商业 计划 书 一 样 ， 规 范 应 突出 重点 ,帮助 避免 项 目 偏 离 轨道 。 这 里 不 会 
制定 完整 的 项 目 规划 ， 只 列 出 一 些 明 确 的 目标 ， 以 突出 开发 的 重点 。 我 们 制定 的 规范 如 下 : 
我 们 要 编写 一 个 名 为 “学 习 笔 记 ” 的 Web 应 用 程序 , 让 用 户 能 够 记录 感 兴 趣 的 主题 ， 
并 在 学 习 每 个 主题 的 过 程 中 添加 日 志 条 目 。“ 学 习 笔 记 ” 的 主页 对 这 个 网 站 进行 描述 ， 并 
邀请 用 户 注 册 或 登录 。 用 户 登 录 后 ， 可 以 创建 新 主题 、 添 加 新 条 目 以 及 阅读 既 有 的 条 目 。 
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学 习 新 的 主题 时 ,记录 学 到 的 知识 可 帮助 跟踪 和 复习 这 些 知识 。 优 秀 的 应 用 程序 让 这 个 记录 
过 程 简单 易 行 。 


18.1.2 ”建立 虚拟 环境 


要 使 用 Django， 首 先 需要 建立 一 个 虚拟 工作 环境 。 虚 拟 环境 是 系统 的 一 个 位 置 ， 可 在 其 中 
安装 包 ， 并 将 之 与 其 他 Python 包 隔 离 。 将 项 目的 库 与 其 他 项 目 分 离 是 有 益 的， 并 且 为 了 在 第 20 
章 将 “学 习 笔记 ”部 署 到 服务 器 ， 这 也 是 必需 的 。 

为 项 目 新 建 一 个 目录 ， 将 其 命名 为 leaming log， 再 在 终端 中 切换 到 这 个 目录 ， 并 执行 如 下 
命令 创建 一 个 虚拟 环境 : 


learning log$ python -m venv 11 env 
learning log$ 


这 里 运行 了 模块 venv， 并 使 用 它 创建 了 一 个 名 为 lL_env 的 虚拟 环境 。( 请 注意 ，1l_env 的 开 
头 是 两 个 小 写字 母 1， 而 不 是 数字 1。) 如 果 你 运行 程序 或 安装 包 时 使 用 的 是 命令 python3， 这 里 
也 务必 使 用 同样 的 命令 。 


18.1.3 激活 虚拟 环境 
现在 需要 使 用 下 面 的 命令 激活 虚拟 环境 : 


learning log$ source 1] env/bin/activate 
@ (1] env)learning log$ 


这 个 命令 运行 1 env/bin 中 的 脚本 activate。 环境 处 于 活动 状态 时 , 环境 名 将 包含 在 圆 括号 内 ， 
如 @ 处 所 示 。 在 这 种 情况 下 ,你 可 以 在 环境 中 安装 包 ， 并 使 用 已 安装 的 包 。 在 1 env 中 安装 的 包 
仅 在 该 环境 处 于 活动 状态 时 才 可 用 。 


注意 ”如 果 你 使 用 的 是 Windows 系统 ， 请 使 用 命令 11 env\Scripts\activate (不 包含 Source ) 
来 激活 这 个 虚拟 环境 。 如 果 你 使 用 的 是 PowerShell, 可 能 需要 将 Activate 的 首 字母 大 写 。 


要 停止 使 用 虚拟 环境 ， 可 执行 命令 deactivate: 


(1] env)learning log$ deactivate 
learning log$ 


如 果 关 闭 运行 虚拟 环境 的 终端 ， 虚 拟 环境 也 将 不 再 处 于 活动 状态 。 
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18.1.4 安装 Django 


激活 虚拟 环境 后 ， 执 行 如 下 命令 安装 Django: 


(11_env)learning log$ pip install django 

Collecting django 

-- Snip-- 

Installing collected packages: pytz, django 

Successfully installed django-2.2.0 pytz-2018.9 sqlparse-0.2.4 
(1] env)learning log$ 


由 于 是 在 虚拟 环境 (独立 的 环境 ) 中 工作 ， 在 各 种 系统 中 安装 Django 的 命令 都 相同 : 不 需 
要 指定 标志 --user， 也 不 需要 使 用 像 python -m pip install package_name 这 样 较 长 的 命令 。 


别 忘 了 ，Django 仅 在 虚拟 环境 11_env 处 于 活动 状态 时 才 可 用 。 


注意 每 隔 大 约 8 个 月 ，Django 新 版 本 就 会 发 布 ， 因 此 在 你 安装 Django 时， 看 到 的 可 能 是 更 新 
的 版 本 。 即 便 你 使 用 的 是 更 新 的 Django 版 本 ， 这 个 项 目 也 可 行 。 如 果 要 使 用 这 里 所 示 的 
Django 版 本 ， 请 使 用 命令 pip install django==2.2.* 安 装 Django 2.2 的 最 新 版 本 。 如 果 
你 在 使 用 更 新 的 版 本 时 遇 到 麻烦 ， 请 参阅 本 书 的 在 线 配套 资源 。 


18.1.5 ”在 Django 中 创建 项 目 


在 虚拟 环境 依然 处 于 活动 状态 的 情况 下 (1L_eny 包含 在 圆 括号 内 )， 执 行 如 下 命令 新 建 一 个 
项 目 : 


@ (1] env)learning log$ django-admin startproject learning log . 
@ (1] env)learning log$ 1s 

learning log ll] env manage.py 
@ (1] env)learning log$ ls learning log 

_init .py settings.py urls.py wsgi.py 


@ 处 的 命令 让 Django 新 建 一 个 名 为 learning log 的 项 目 。 这 个 命令 末尾 的 句点 让 新 项 目 使 用 
合适 的 目录 结构 ， 这 样 开发 完成 后 可 轻松 地 将 应 用 程序 部 署 到 服务 需 。 


注意 千 万 别 忘 了 这 个 句点 ,否则 部 署 应 用 程序 时 将 遵 遇 一 些 配置 问题 。 如 果 忘 记 了 这 个 句点 ， 
要 删除 已 创建 的 文件 和 文件 夹 (11 env 除外 )， 再 重新 运行 这 个 命令 。 


在 @ 人 处， 运行 命令 ls (在 Windows 系统 上 为 dir )， 结 果 表 明 Django 新 建 了 一 个 名 为 
leaming log 的 目录 ， 还 创建 了 文件 manage.py。 后 者 是 一 个 简单 的 程序 ， 接 受命 令 并 将 其 交 给 
Django 的 相关 部 分 运行 。 我 们 将 使 用 这 些 命 令 来 管理 使 用 数据 库 和 运行 服务 器 等 任务 。 


目录 leaming log 包含 4 个 文件 ( 见 @ ), 最 重要 的 是 settingspy、urls.py 和 wsgipy。 文件 settings.py 
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上 定 Django 如 何 与 系统 交互 以 及 如 何 管理 项 目 。 在 开发 项 目的 过 程 中 ， 我 们 将 修改 其 中 一 些 设 
置 , 并 添加 一 些 设置 。 文件 urls.py 告诉 Django, 应 创建 哪些 页 面 来 响应 浏览 器 请 求 。 文件 wsgi.py 
帮助 Django 提供 它 创 建 的 文件 ， 这 个 文件 名 是 Web 服务 器 网 关 接口 ( Web server gateway interface ) 
的 首 字 母 缩 写 。 


18.1.6 ”创建 数据 库 


Django 将 大 部 分 与 项 目 相关 的 信息 存储 在 数据 库 中 ， 因 此 需要 创建 一 个 供 Django 使 用 的 数 
据 库 。 为 给 项 目 “ 学 习 笔 记 ” 创建 数据 库 , 请 在 虚拟 环境 处 于 活动 状态 的 情况 下 执行 下 面 的 命令 : 


(1] env)learning log$ python manage.py migrate 
@ Operations to perform: 
Apply all migrations: admin, auth, contenttypes, sessions 
Running migrations: 
Applying contenttypes.0001 initial... OK 
Applying auth.0001 initial... OK 
-- Snip-- 
Applying sessions.0001 initial... OK 
@ (ll env)learning log$ ls 
db.sqlite3 learning log ll] env manage.py 


我 们 将 修改 数据 库 称 为 迁移 (migrate ) 数据 库 。 首 次 执行 命令 migrate 时 ， 将 让 Django 确 
保 数据 库 与 项 目的 当前 状态 匹配 。 在 使 用 SQLite ( 后 面 将 详细 介绍 ) 的 新 项 目 中 首次 执行 这 个 命 
令 时 ，Django 将 新 建 一 个 数据 库 。 在 @@ 处 ，Django 指出 它 将 准备 好 数据 库 ， 用 于 存储 执行 管理 
和 身份 验证 任务 所 需 的 信息 。 


在 @ 处 运行 命令 1s， 其 输出 表明 Django 又 创建 了 一 个 文件 db.sqlite3 。SQLite 是 一 种 使 用 单 
个 文件 的 数据 库 ， 是 编写 简单 应 用 程序 的 理想 选择 ， 因 为 它 让 你 不 用 太 关注 数据 库 管理 的 问题 。 


注意 在 虚拟 环境 中 运行 manage.py 时 ， 务 必 使 用 命令 python， 即 便 你 在 运行 其 他 程序 时 使 用 
的 是 另外 的 命令 ， 如 python3。 在 虚拟 环境 中 ， 命 令 python 指 的 是 在 虚拟 环境 中 安装 的 
Python 版 本 。 


18.1.7 ”查看 项 目 


下 面 来 核实 Django 正确 地 创建 了 项 目 。 为 此 , 可 使 用 命令 runserver 查看 项 目的 状态 , 如 下 
所 示 : 


(11_ env)learning log$ python manage.py runserver 
Watchman unavailable: pywatchman not installed. 
Watching for file changes with StatReloader 
Performing System checks... 


@ System check identified no issues (0 silenced) . 

February 18, 2019 - 16:26:07 
@ Django version 2.2.0, Using settings 'learning log.settings’ 
四 Starting development server at http://127.0.0.1:8000/ 

Quit the server with CONTROL-C. 


Django 启动 了 一 个 名 为 development server 的 服务 器 ， 证 你 能 够 查看 系统 中 的 项 目 ， 了 解 其 
工作 情况 。 如 果 你 在 浏览 器 中 输入 URL 以 请 求 页 面 , 该 Django 服务 器 将 进行 响应 : 生成 合适 的 
页 面 ， 并 将 其 发 送 给 浏览 器 。 

Django 在 @ 处 通过 检查 确认 正确 地 创建 了 项 目 ， 在 @@ 处 指出 使 用 的 Django 版 本 以 及 当前 使 
用 的 设置 文件 的 名 称 , 并 在 四 处 指出 项 目的 URL。URL http:/127.0.0.1:8000/ 表 明 项 目 将 在 你 的 计 
算 机 ( 即 localhost ) 的 端口 8000 上 侦 听 请 求 。localhost 指 的 是 只 处 理 当 前 系统 发 出 的 请 求 ， 而 不 
允许 其 他 任何 人 查看 你 正在 开发 的 页 面 的 服务 器 。 


现在 打开 一 款 Web 浏览 器 ， 并 输入 URL http://localhost:8000/( 如果 这 不 管用 ， 请 输入 
http://127.0.0.1:8000/ )。 你 将 看 到 类 似 于 图 18-1 所 示 的 页 面 。 这 个 页 面 是 Django 创建 的 ， 让 你 知 
道 到 目前 为 止 一 切 正常 。 现 在 暂时 不 要 关闭 这 个 服务 器 ,等 你 要 关闭 这 个 服务 器 时 ,可 切换 到 执 
行 命令 runserver 时 所 在 的 终端 窗口 ， 再 按 Ctrl + C。 


®@8@ 〈 加 | © localhost:8000 ©| oma 苞 


django View release notes for Django dev 


(| 


时 


The install worked successfully! Congratulations! 


You are seeing this page because DEBUG=True is in 
your settings file and you have not configured any 
URLs. 


QQ Django Documentation Tutorial: A Polling App oo Django Community 
《> < 
二 ” Topics, references, & how-tos Get started with Django Connect get help, or contribute 


图 18-1 到 目前 为 止 一 切 正常 


注意 ”如果 出 现 错误 消息 That port is already in use ( 指定 端口 被 占用 )， 请 执行 命令 python 
manage.py runserver 8001， 让 Diango 使 用 另 一 个 端口 。 如 果 这 个 端口 也 不 可 用 ， 请 不 
断 执 行 上 述 命令 ， 并 逐渐 增 大 其 中 的 端口 号 ， 直 到 找到 可 用 的 端口 。 


348 第 18 章 从 Django 入 手 


人 
练习 18-1: 新 项 目 为 深入 了 解 Django 都 做 了 些 什 么 ， 可 创建 两 个 空 项 目 ， 看 看 
Django 创建 了 什么 。 新 建 一 个 文件 夹 ， 并 给 它 指定 简单 的 名 称 , 如 snap_gram 或 insta_ chat 
(不 要 在 目录 learning log 中 新 建 该 文件 夹 ), 在 终端 中 切换 到 该 文件 夹 ， 并 创建 一 个 虚 


拟 环境 。 在 这 个 虚拟 环境 中 ， 安 装 Django， 并 执行 命令 django-admin.py startproject 
snap gram .( 千 万 不 要 忘 了 这 个 命令 末尾 的 句点 )。 

看 看 这 个 命令 创建 了 哪些 文件 和 文件 夹 ， 并 与 项 目 “ 学 习 笔记 ”包含 的 文件 和 文件 
夹 进 行 比较 。 这 样 多 做 几 次 ， 直 到 你 对 Django 新 建 项 目 时 创建 的 东西 了 如 指 掌 。 然 后 ， 
将 项 目 目录 删除 ( 如 果 你 想 这 样 做 的 话 )。 


18.2 ”创建 应 用 程序 
Django 项 目 由 一 系列 应 用 程序 组 成 , 它们 协同 工作 让 项 目 成 为 一 个 整体 。 本 章 只 创建 一 个 应 
用 程序 ， 它 将 完成 项 目的 大 部 分 工作 。 第 19 章 将 添加 一 个 管理 用 户 账 户 的 应 用 程序 。 


当前 ， 在 前 面 打开 的 终端 窗口 中 应 该 还 运行 着 runserver。 请 再 打开 一 个 终端 窗口 (或 标签 
页 )， 并 切换 到 manage.py 所 在 的 目录 。 激 活 虚 拟 环境 ， 再 执行 命令 startapp: 


learning log$ source 1] env/bin/activate 
(1] env)learning log$ python manage.py startapp learning logs 
@ (ll env)learning log$ 1s 
db.sqlite3 learning log learning logs 1l1 env manage.py 
@ (ll env)learning log$ ls learning logs/ 
_ init .py admin.py apps.py migrations models.py tests.py views.py 


命令 startapp appname 让 Django 搭建 创建 应 用 程序 所 需 的 基础 设施 。 如 果 现 在 查看 项 目 目 
录 ， 将 看 到 其 中 新 增 了 文件 夹 learning logs ( 见 @ )。 打 开 这 个 文件 夹 ， 看 看 Django 都 创建 了 什 
么 ( 见 @ ), 其 中 最 重要 的 文件 是 models.py、admin.py 和 views.py。 我们 将 使 用 models.py 来 定义 
要 在 应 用 程序 中 管理 的 数据 ， 稍 后 再 介绍 admin.py 和 views.py。 


ee 


18.2.1 定义 模型 


我 们 来 想 想 涉及 的 数据 。 每 位 用 户 都 需要 在 学 习 笔记 中 创建 很 多 主题 。 用 户 输入 的 每 个 条 目 
都 与 特定 主题 相关 联 , 这 些 条 目 将 以 文本 的 方式 显示 。 我 们 还 需要 存储 每 个 条 目的 时 间 稚 ,以 便 
告诉 用 户 各 个 条 目 都 是 什么 时 候 创建 的 。 


打开 文件 models.py， 看 看 它 当 前 包含 哪些 内 容 : 
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models.py from django.db import models 


# 在 这 里 创建 模型 。 


这 里 导入 了 模块 models， 并 让 我 们 创建 自己 的 模型 。 模 型 告诉 Django 如 何 处 理应 用 程序 中 


存储 的 数据 。 在 代码 层面 ,模型 就 是 一 个 类 ,就 像 前 面 讨论 的 每 个 类 一 样 ， 包含 属性 和 方法 。 下 


面 是 表示 用 户 将 存储 的 主题 的 模型 : 


from django.db import models 


class Topic(models.Model): 
text = models.CharField(max_length=200) 
date added = models.DateTimeField(auto now add=True) 


© 


(3 def str (self): 
""" 返 回 模 型 的 字符 囊 表 示 。""" 
return self.text 


我 们 创建 了 一 个 名 为 Topic 的 类 ， 它 继承 Model， 即 Django 中 定义 了 模型 基本 功能 的 类 。 我 


们 给 Topic 类 添加 了 两 个 属性 : text 和 date added。 


属性 text 是 一 个 CharField 


由 字符 组 成 的 数据 ， 即 文本 ( 见 @ )。 需 要 存储 少量 文本 ， 


如 名 称 、 标 题 或 城市 时 ， 可 使 用 CharField。 定 义 CharField 
库 中 预 留 多 少 空间 。 这 里 将 max_length 设置 成 了 200 ( 即 20 
说 足够 了 。 

高 性 date_added 是 一 个 DateTimeField 
auto_now_add=True， 每 当 用 户 创建 新 主题 时 ，Dijango 都 会 将 这 


属性 时 ， 必 须 告 诉 Django 该 在 数据 
0 字符 )， 这 对 存储 大 多 数 主题 名 来 


记录 日 期 和 时 间 的 数据 ( 见 @ )。 我 们 传递 了 实 参 


个 属性 自动 设置 为 当前 日 期 和 时 间 。 


注意 要 获悉 可 在 模型 中 使 用 的 各 种 字段 ， 请 参阅 Django Model Field Rejerenrce。 就 当前 而 言 ， 
你 无 须 全 面 了 解 其 中 的 所 有 内 容 , 但 自己 开发 应 用 程序 时 ,这 些 内 容 将 提供 极 大 的 帮助 。 


需要 告诉 Django， 默 认 使 用 哪个 属性 来 显示 有 关 主 题 的 信息 。Django 调用 方法 _str () 来 
显示 模型 的 简单 表示 。 这 里 编写 了 方法 _str ()， 它 返回 存储 在 属性 text 中 的 字符 串 ( 见 @ )。 


18.2.2 ”激活 模型 
要 使 用 这 些 模型 ， 必 须 让 Django 将 前 述 应 用 程序 包含 


到 项 目 中 。 为 此 ， 打 开 settings.py 


〈 它 位 于 目录 learming log/learning_ log 中 )， 其 中 有 个 片段 告诉 Django 哪些 应 用 程序 被 安装 到 了 


项 目 中 并 将 协同 工作 : 
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settings.py -- Snip-- 

INSTALLED APPS = [ 
“django.contTrib.admin ， 
“django.contTrib.auth ， 
“django.contTrib.contenttypes ， 
'django.contrib.sessions', 
‘django.contrib.messages', 
‘django.contrib.staticfiles', 


] 


-- Snip-- 


请 将 INSTALLED_APPS 修改 成 下 面 这 样 ， 将 前 面 的 应 用 程序 添加 到 这 个 列表 中 : 


-- Ship-- 
INSTALLED APPS = [ 
# 我 的 应 用 程序 


'learning logs', 


# 默认 添加 的 应 用 程序 
“django.contrib.admin ， 
-- Snip-- 
] 


-- Snip-- 


通过 将 应 用 程序 编组 ,在 项 目 不 断 增 大 , 包含 更 多 的 应 用 程序 时 ,有 助 于 对 应 用 程序 进行 跟 
踪 。 这 里 新 建 了 一 个 名 为 “我 的 应 用 程序 ”的 片段 ， 当 前 它 只 包含 应 用 程序 learning logs。 务 
必 将 自己 创建 的 应 用 程序 放 在 默认 应 用 程序 前 面 ， 这 样 能 够 覆盖 默认 应 用 程序 的 行为 。 


接 下 来 ， 需 要 让 Django 修改 数据 库 ， 使 其 能 够 存储 与 模型 Topic 相关 的 信息 。 为 此 ， 在 终 
端 窗口 中 执行 下 面 的 命令 : 


(11_env)learning_1o8g$ python manage.py makemigrations learning logs 
Migrations for 'learning logs': 
learning logs/migrations/0001 initial.py 
- Create model Topic 
(1] env)learning log$ 


命令 makemigrations 让 Django 确定 该 如 何 修改 数据 库 ， 使 其 能 够 存储 与 前 面 定义 的 新 模型 
相关 联 的 数据 。 输 出 表明 Django 创建 了 一 个 名 为 0001_initial.py 的 迁移 文件 ,这 个 文件 将 在 数据 
库 中 为 模型 Topic 创建 一 个 表 。 


下 面 应 用 这 种 迁移 ， 让 Django 蔡 我 们 修改 数据 库 : 


(11_env)learning log$ python manage.py migrate 
Operations to perform: 
Apply all migrations: admin, auth, contenttypes, learning logs, sessions 
Running migrations: 
@ Applying learning logs.0001 initial... OK 
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这 个 命令 的 大 部 分 输出 与 首次 执行 命令 migrate 的 输出 相同 。 需 要 检查 的 是 @ 处 的 输出 行 。 
在 这 里 ，Django 指出 为 learning logs 应 用 迁移 时 一 切 正 常 。 


每 当 需 要 修改 “学 习 笔 记 ” 管 理 的 数据 时 ， 都 采取 如 下 三 个 步骤 : 修改 modelspy， 对 
learning logs 调用 makemigrations， 以 及 让 Django 迁移 项 目 。 


18.2.3 ”Django 管理 网 站 


Django 提供 的 管理 网 站 (admin site ) 让 你 能 够 轻松 地 处 理 模型 。 网 站 管理 员 可 以 使 用 管理 
网 站 ， 但 普通 用 户 不 能 使 用 。 本 节 将 建立 管理 网 站 ， 并 通过 它 使 用 模型 Topic 来 添加 一 些 主题 。 


1. 创建 超级 用 户 

Django 允许 创建 具备 所 有 权限 的 用 户 , 即 超级 用 户 。 权 限 决定 了 用 户 可 执行 的 操作 。 最 严格 
的 权限 设置 只 允许 用 户 阅读 网 站 的 公开 信息 。 注 册 用 户 通常 可 阅读 自己 的 私有 数据 , 还 可 查看 一 
些 只 有 会 员 才 能 查看 的 信息 。 为 有 效 地 管理 Web 应 用 程序 ， 网 站 所 有 者 通常 需要 访问 网 站 存储 


的 所 有 信息 。 优 秀 的 管理 员 会 小 心 对 待 用 户 的 敏感 信息 , 因为 用 户 极其 信任 自己 访问 的 应 用 程序 。 
为 在 Django 中 创建 超级 用 户 ， 请 执行 下 面 的 命令 并 按 提示 做 : 


(11 env)learning log$ python manage.py createsuperuser 
@ Username (leave blank to use 'eric'): 11 admin 
@ Email address: 
四 Password: 

Password (again): 

Superuser created successfully. 

(11 env)learning log$ 


你 执行 命令 createsuperuser 时 ，Django 提示 输入 超级 用 户 的 用 户 名 ( 见 @ )。 这 里 输入 的 
是 1Ladmin， 但 可 输入 任何 用 户 名 。 如 果 你 愿意 ， 可 以 输入 电子 邮箱 地 址 ， 也 可 让 这 个 字段 为 
空 ( 见 @ )。 需 要 输入 密码 两 次 ( 见 @ )。 


注意 “一些 敏感 信息 可 能 会 向 网 站 管理 员 隐藏 。 例 如 ，Django 并 不 存储 你 输入 的 密码 ， 而 是 存储 
从 该 密码 派生 出 来 的 一 个 字符 串 ， 称 为 散 列 值 。 每 当 你 输入 密码 时 ，Django 都 计算 其 散 列 
值 ， 并 将 结果 与 存储 的 散 列 值 进行 比较 。 如 果 这 两 个 散 列 值 相 同 ， 你 就 通过 了 身份 验证 。 
由 于 存储 的 是 散 列 值 ， 即 便 黑 客 获得 了 网 站 数据 库 的 访问 权 ， 也 只 能 获取 其 中 存储 的 散 列 
值 ， 无 法 获得 密码 。 在 网 站 配置 正确 的 情况 下 ， 几 乎 无 法 根据 散 列 值 推导 出 原始 密码 。 


2. 向 管理 网 站 注册 模型 
Django 自动 在 管理 网 站 中 添加 了 一 些 模 型 ,如 User 和 Group, 但 对 于 我 们 创建 的 模型 ， 必 须 
手工 进行 注册 。 
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我 们 创建 应 用 程序 learning logs 时 ，Django 在 models.py 所 在 的 目录 中 创建 了 一 个 名 为 
admin.py 的 文件 : 


admin.py from django.contrib import admin 


# 在 这 里 注册 你 的 模型 。 


为 向 管理 网 站 注册 Topic， 请 输入 下 面 的 代码 : 


from django.contrib import admin 
@ from .models import Topic 


@ admin.site.register(Topic) 


这 些 代 码 首 先导 入 要 注册 的 模型 Topic ( 见 @ )。models 前 面 的 句点 让 Django 在 admin.py 所 
在 的 目录 中 查找 models.py。admin.site.register() 让 Django 通过 管理 网 站 管理 模型 ( 见 @ )。 


现在 ， 使 用 超级 用 户 账 户 访问 管理 网 站 : 访问 http://localhost:8000/admin/， 并 输入 刚 创 建 的 
超级 用 户 的 用 户 名 和 密码 。 你 将 看 到 类 似 于 图 18-2 所 示 的 屏幕 。 这 个 页 面 让 你 能 够 添加 和 修改 
用 户 和 用 户 组 ， 还 可 管理 与 刚才 定义 的 模型 Topic 相关 的 数据 。 


四 四 四 “ 加 | © localhost:8000/admin ©] @ ai 


jelez[eliiliilStcitell WELCOME LL_ADMIN. VIEW SITE / CHANGE PASSWORD / LOG OUT 


Site administration 


AUTHENTICATION AND AUTHORIZATION 


Recent actions 
Groups 十 Add Change 
Users 十 Add Change My actions 


None available 


LEARNING_LOGS 


Topics 十 Add Change 


图 18-2 包含 模型 Topic 的 管理 网 站 


注意 ”如果 在 浏览 器 中 看 到 一 条 消息 ， 指 出 访问 的 网 页 不 可 用 ， 请 确认 在 终端 窗口 中 运行 着 
Django 服务 器 。 如 果 没 有 ， 请 激活 虚拟 环境 ， 并 执行 命令 python manage.py runserver。 
在 开发 过 程 中 ， 如 果 无 法 通过 浏览 器 访问 项 目 ， 首 先 应 采取 的 故障 排除 措施 是 ， 关 闭 所 
有 打开 的 终端 ， 再 打开 终端 并 执行 命令 TunseTveT。 
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3. 添加 主题 

向 管理 网 站 注册 Topic 后 ,我 们 来 添加 第 一 个 主题 。 为 此 ， 单 击 Topics 进入 主题 页 面 ， 它 几 
乎 是 空 的 ， 因 为 还 没有 添加 任何 主题 。 单 击 Add, 将 出 现 一 个 用 于 添加 新 主题 的 表单 。 在 第 一 个 
方 框 中 输入 Chess， 再 单 击 Save 回 到 主题 管理 页 面 ， 其 中 包含 刚 创建 的 主题 。 

下 面 再 创建 一 个 主题 ， 以 便 有 更 多 的 数据 可 供 使 用 。 再 次 单 击 Add， 并 输入 Rock Climbing， 
然后 单 击 Save 回 到 主题 管理 页 面 。 现 在 ， 你 可 以 看 到 其 中 包含 了 主题 Chess 和 Rock Climbing。 


~ 


18.2.4 定义 模型 Entry 


要 记录 学 到 的 国际 象棋 和 攀岩 知识 , 用户 必 须 能 够 在 学 习 笔 记 中 添加 条 目 。 为 此 , 需要 定义 
相关 的 模型 。 每 个 条 目 都 与 特定 主题 相关 联 ， 这 种 关系 称 为 多 对 一 关系 ， 即 多 个 条 目 可 关联 到 同 
一 个 主题 。 


下 面 是 模型 Entry 的 代码 ， 请 将 这 些 代 码 放 在 文件 models.py 中 : 


models.py from django.db import models 


class Topic(models.Model): 
-- Snip-- 


@ class Entry(models.Model): 

""" 学 到 的 有 关 某 个 主题 的 具体 知识 。""" 
© topic = models.ForeignKey(Topic, on delete=models .CASCADE) 
(3 text = models.TextField() 

date added = models.DateTimeField(auto now add=True) 


Q class Meta: 
verbose name plural = 'entries' 


def str (self): 
""" 返 回 模型 的 字符 囊 表 示 。""" 
(5) return f"{self.text[:50]}..." 


像 Topic 一样 , Entry 也 继承 了 Django 基 类 Model( 见 @ ), 第 一 个 属性 topic 是 个 ForeignKey 
实例 ( 见 @ )。 外 键 (foreign key ) 是 一 个 数据 库 术语 ， 它 指向 数据 库 中 的 另 一 条 记录 ， 这 里 是 将 
每 个 条 目 关联 到 特定 主题 。 创 建 每 个 主题 时 ， 都 分 配 了 一 个 键 (ID )。 需 要 在 两 项 数据 之 间 建 立 
联系 时 , Django 使 用 与 每 项 信息 相关 联 的 键 。 我 们 稍 后 将 根据 这 些 联系 获取 与 特定 主题 相关 联 的 
所 有 条 目 。 实 参 on_delete=models .CASCADE 让 Django 在 删除 主题 的 同时 删除 所 有 与 之 相关 联 的 
条 目 ， 这 称 为 级 联 删除 ( cascading delete )。 


接 下 来 是 属性 text， 它 是 一 个 TextField 实例 ( 见 @ )。 这 种 字段 的 长 度 不 受 限制 ， 因 为 我 
们 不 想 限制 条 目的 长 度 。 属 性 date_added 让 我 们 能 够 按 创建 顺序 呈现 条 目 ， 并 在 每 个 条 目 旁 边 
放置 时 间 戳 。 
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在 @ 处 ,我 们 在 Entry 类 中 骸 套 了 Meta 类 。Meta 存储 用 于 管理 模型 的 额外 信息 。 在 这 里 ， 
它 让 我 们 能 够 设置 一 个 特殊 属性 ， 让 Django 在 需要 时 使 用 Entries 来 表示 多 个 条 日。 如果 没 有 
这 个 类 ，Django 将 使 用 Entrys 来 表示 多 个 条 目 。 

方法 _str () 告 诉 Django， 呈 现 条 目 时 应 显示 哪些 信息 。 条 目 包 含 的 文本 可 能 很 长 ， 因 此 
让 Django 只 显示 text 的 前 30 字符 ( 见 @ )。 我们 还 添加 了 一 个 省 略 号 ， 指 出 显示 的 并 非 整 个 
条 目 。 


18.2.5 ”迁移 模型 Entry 


添加 新 模型 后 ， 需 要 再 次 迁移 数据 库 。 你 将 慢 慢 地 对 这 个 过 程 了 如 指 掌 : 修改 models.py， 
执行 命令 python manage.py makemigrations app name， 再 执行 命令 python manage.py migrate。 


请 使 用 如 下 命令 迁移 数据 库 并 查看 输出 : 


(11_env)learning log$ python manage.py makemigrations learning logs 
Migrations for 'learning logs': 
@ learning logs/migrations/0002 entry.py 
- Create model Entry 
(1] env)learning log$ python manage.py migrate 
Operations to perform: 
-- Snip-- 
@ Applying learning logs.0002 entry... OK 


生成 了 一 个 新 的 迁移 文件 0002_entry.py， 它 告诉 Django 如 何 修改 数据 库 ， 使 其 能 够 存储 与 
模型 Entry 相关 的 信息 ( 见 @ ), 在 @ 处 执行 命令 migrate, 我 们 发 现 Django 应 用 了 该 迁移 且 一 切 
顺利 。 


18.2.6 ”向 管理 网 站 注册 Entry 
我 们 还 需要 注册 模型 Entry。 为 此 ， 需 要 将 admin.py 修改 成 类 似 于 下 面 这 样 : 


admin.py from django.contrib import admin 
from .models import Topic, Entry 


admin.site.register(Topic) 
admin.site.register(Entry) 


返回 到 http://localhost/admin/, 你 将 看 到 Learning Logs 下 列 出 了 Entries。 单 击 Entries 的 Add 
链接 ,或 者 单 击 Entries 再 选择 Add entry ， 将 看 到 一 个 下 拉 列 表 ， 供 你 选择 要 为 哪个 主题 创建 条 
目 ， 以 及 一 个 用 于 输入 条 目的 文本 框 。 从 下 拉 列 表 中 选择 Chess， 并 添加 一 个 条 目 。 下 面 是 我 添 
加 的 第 一 个 条 目 。 
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The opening is the first part of the game, roughly the first ten moves or so. In the opening, 
it’s a good idea to do three things— bring out your bishops and knights, try to control the center 
of the board, and castle your king. ( 国际 象棋 的 第 一 个 阶段 是 开局 ， 大 致 是 前 10 步 左 右 。 
在 开局 阶段 ， 最 好 做 三 件 事情 : 将 象 和 马 调 出 来 ， 努 力 控制 棋盘 的 中 间 区 域 ， 以 及 用 车 


将 王 护 住 。) 


Of course, these are just guidelines. It will be Important to learn when to follow these 
guidelines and when to disregard these suggestions. ( 当然 ， 这 些 只 是 指导 原则 。 学 习 什 么 


情况 下 遵守 这 些 原则 、 什 么 情况 下 不 用 遵守 很 重要 。) 


当 你 单 击 Save 时 , 将 返回 到 主 条 目 管 理 页面 。 在 这 里 ， 你 将 发 现 使 用 text[ :50] 作 为 条 目的 


字符 串 表 示 的 好 处 : 在 管理 界面 中 只 显示 了 条 目的 开头 部 分 而 不 是 其 所 有 文本 , 这 使 得 管理 多 个 
条 目 容 易 得 多 。 


际 象棋 条 目 。 


再 来 创建 一 个 国际 象棋 条 目 ， 并 创建 一 个 攀岩 条 目 ， 以 提供 一 些 初始 数据 。 下 面 是 第 二 个 国 


In the opening phase of the game, it's Important to bring out your bishops and knights. 


These pieces are powerful and maneuverable enough to play a significant role in the beginning 


moves of a game.( 在 国际 象棋 的 开局 阶段 ， 将 象 和 马 调 出 来 很 重要 。 这 些 棋子 威力 大 ， 


机 动 性 强 ， 在 开局 阶段 扮演 着 重要 角色 。) 


下 面 是 第 一 个 攀岩 条 目 。 


One of the most Important concepts in climbing is to keep your weight on your feet as 


much as possible. There’s a myth that climbers can hang all day on their arms. In reality, good 


climbers have practiced Specific ways of keeping their weight over their feet whenever possible. 


(最 重要 的 攀岩 概念 之 一 是 尽 可 能 让 双 脚 承受 体重 。 有 人 误 认 为 攀岩 者 能 依靠 手臂 的 力 
量 坚持 一 整 天 。 实 际 上 , 优秀 的 攀岩 者 都 经 过 专门 训练 ， 能 够 尽 可 能 让 双 脚 承受 体重 。) 


接着 往 下 开发 “学 习 笔 记 ” 时 ， 这 三 个 条 目 提 供 了 可 供 使 用 的 数据 。 


18.2.7 Django shell 


输入 一 些 数据 后 , 就 可 通过 交互 式 终端 会 话 以 编程 方式 查看 这 些 数据 了 。 这 种 交互 式 环境 称 


为 Django shell， 是 测试 项 目 和 排除 故障 的 理想 之 地 。 下 面 是 一 个 交互 式 shell 会 话 示 例 : 


(11_env)learning log$ python manage.py shell 
@ >>> from learning logs.models import Topic 
>>> Topic.objects.all() 
<QuerySet [<Topic: Chess>, <Topic: Rock Climbing>]> 
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在 活动 状态 的 虚拟 环境 中 执行 时 ,命令 python manage.py shell 启动 Python 解释 器 ， 
能 够 探索 存储 在 项 目 数据 库 中 的 数据 。 这 里 导入 了 模块 learning_logs .models 中 的 模型 


让 你 


Topic 


( 见 @ ), 再 使 用 方法 Topic.objects.all() 获 取 模 型 Topic 的 所 有 实例 , 这 将 返回 一 个 称 为 查询 集 


( queryset ) 的 列表 。 
可 以 像 遍历 列表 一 样 遍历 查询 集 。 下 面 演示 了 如 何 查看 分 配给 每 个 主题 对 象 的 ID : 


>>> topics = Topic.objects.all() 
>>> for topic in topics: 
print(topic.id, topic) 


1 Chess 
2 Rock Climbing 


将 返回 的 查询 集 存储 在 topics 中 ， 再 打印 每 个 主题 的 id 属性 和 字符 串 表示 。 从 输出 可 知 ， 


主题 Chess 的 ID 为 1， 而 Rock Climbing 的 ID 为 2。 


知道 主题 对 象 的 ID 后 ， 就 可 使 用 方法 Topic.objects.get() 获 取 该 对 象 并 查看 其 属性 。 
来 看 看 主题 Chess 的 属性 text 和 date_added 的 值 : 


下 面 


>>> t = Topic.objects.get(id=1) 

>>> t.text 

‘Chess" 

>>> t.date added 

datetime.datetime(2019, 2, 19, 1, 55, 31, 98500, tzinfo=<UTC>) 


我 们 还 可 以 查看 与 主题 相关 联 的 条 目 。 前 面 给 模型 Entry 定义 了 属性 topic。 这 是 一 个 
Foreignkey， 将 条 目 与 主题 关联 起 来 。 利 用 这 种 关联 ，Dijango 能 够 获取 与 特定 主题 相关 联 的 所 有 


条 目 ， 如 下 所 示 : 


@ >>> t.entry set.all() 
<QuerySet [<Entry: The opening is the first part of the game, roughly...>, 
<Entry: 
In the opening phase of the game, it's important 七 ...>]> 


要 通过 外 键 关系 获取 数据 ， 可 使 用 相关 模型 的 小 写 名 称 、 下 划 线 和 单词 set( 见 @ )。 例 如 ， 
假设 有 模型 Pizza 和 Topping， 而 Topping 通过 一 个 外 键 关联 到 Pizza。 如 果 有 一 个 名 为 my_pizza 


的 Pizza 对 象 ， 就 可 使 用 代码 my_pizza.topping_set.all() 来 获取 这 张 比 萨 的 所 有 配料 。 


帮助 。 如 果 代码 在 shell 中 的 行为 符合 预期 ， 那 么 它们 在 项 目 文件 中 也 能 正确 地 工作 。 如 曙 


编写 用 户 可 请 求 的 页 面 时 , 我 们 将 使 用 这 种 语法 。 确 认 代码 能 获取 所 需 的 数据 时 ，shell 很 有 


代码 


引发 了 错误 或 获取 的 数据 不 符合 预期 ， 那 么 在 简单 的 shell 环境 中 排除 故障 要 比 在 生成 页 面 的 文 
件 中 排除 故障 容易 得 多 。 我 们 不 会 太 多 地 使 用 shell, 但 应 继续 使 用 它 来 熟悉 对 存储 在 项 目 中 的 数 


据 进行 访问 的 Django 话 法 。 


18.3 创建 页 面 : 学 习 笔 记 主 页 357 


注意 每 次 修改 模型 后 ， 都 需要 重启 shell， 这样 才 能 看 到 修改 的 效果 。 要 退出 shell 会 话 ， 可 按 
Ctr+D。 如 果 你 使 用 的 是 Windows 系统 ， 应 按 Ctr+Z， 再 按 回 车 键 。 


动手 试 一 斌 

练习 18-2: 简短 的 条 目 当前，Django 在 管理 网 站 或 shell 中 显示 Entry 实例 时 ， 
模型 Entry 的 方法 _ str () 都 在 其 末尾 加 上 省 略 号 。 请 在 方法 str () 中 添加 一 条 if 
语句 ， 以 便 仅 在 条 目 长 度 超 过 50 字符 时 才 添 加 省 略 号 。 使 用 管理 网 站 添加 一 个 不 超过 
50 字符 的 条 目 ， 并 核实 显示 它 时 没有 省 略 号 。 


练习 18-3: Django API 当 你 编写 访问 项 目 中 数据 的 代码 时 ， 实 际 上 编写 的 是 查 
询 。 请 浏览 Django 网 站 中 有 关 如 何 查询 数据 的 文档 Making queries， 其 中 大 部 分 内 容 是 


你 不 熟悉 的 ， 但 等 你 自己 开发 项 目 时 ， 这 些 内 容 会 很 有 用 。 

练习 18-4: 比萨 店 新 建 一 个 名 为 Pizzeria 的 项 目 ， 并 在 其 中 添加 一 个 名 为 pizzas 的 
应 用 程序 。 定 义 一 个 名 为 Pizza 的 模型 , 它 包含 字段 name, 用 于 存储 比萨 名 称 , 如 Hawaiian 
和 Meat Lovers。 定义 一 个 名 为 Topping 的 模型 , 它 包含 字段 pizza 和 name, 其 中 字段 pizza 
是 一 个 关联 到 Pizza 的 外 键 ， 而 字段 name 用 于 存储 配料 ， 如 pineapple、Canadian bacon 
和 sausage。 

向 管理 网 站 注册 这 两 个 模型 ， 并 使 用 管理 网 站 输入 一 些 比萨 名 和 配料 。 使 用 shell 
来 查看 你 输入 的 数据 。 
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使 用 Diango 创建 页 面 的 过 程 分 三 个 阶段 : 定义 URL， 编 写 视 图 和 编写 模板 。 按 什么 顺序 完 
成 这 三 个 阶段 无 关 紧 要 , 但 在 本 项 目 中 , 总 是 先 定 义 URL 模式 。URL 模式 描述 了 URL 是 如 何 设 
计 的 ， 让 Django 知道 如 何 将 浏览 絮 请 求 与 网 站 URL 匹配 ， 以 确定 返回 哪个 页 面 。 


每 个 URL 都 被 映射 到 特定 的 视图 一 一 视图 函数 获取 并 处 理 页 面 所 需 的 数据 。 视 图 函数 通常 
使 用 模板 来 泻 染 页 面 ， 而 模板 定义 页 面 的 总 体 结构 。 为 明白 其 中 的 工作 原理 ,我 们 来 创建 当 
记 的 主页 。 这 包括 定义 该 主页 的 UREL， 编 写 其 视图 函数 并 创建 一 个 简单 的 模板 。 


我 们 只 是 要 确保 “学 习 笔 记 ” 按 要 求 的 那样 工作 ， 因 此 暂时 让 这 个 页 面 尽 可 能 简单 。Web 应 
用 程序 能 够 正常 运行 后 , 设置 样式 可 使 其 更 有 趣 , 但 中 看 不 中 用 的 应 用 程序 毫 无 意义 。 就 目前 而 
言 ， 主 页 上 只 显示 标题 和 简单 的 描述 。 


Wh 
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18.3.1 映射 URL 


用 户 通 过 在 浏览 器 中 输入 URL 以 及 单 击 链接 来 请 求 页 面 ， 因 此 我 们 要 确定 项 目 需要 哪些 
URL。 主页 的 URL 最 重要 , 它 是 用 户 用 来 访问 项 目的 基础 URL。 当前 , 基础 URL(http:/localhost: 
8000/ ) 返回 默认 的 Django 网 站 ， 让 我 们 知道 正确 地 建立 了 项 目 。 下 面 修改 这 一 点 ， 将 这 个 基础 
URL 映射 到 “学 习 笔 记 ” 的 主页 。 


打开 项 目 主 文件 夹 learning log 中 的 文件 urls.py， 你 将 看 到 如 下 代码 : 


urks.py 四 from django.contrib import admin 
from django.urls import path 


@ urlpatterns = [ 
(3 path('admin/', admin.site.urls), 
] 


前 两 行 导 入 了 一 个 模块 和 一 个 函数 ， 以 便 对 管理 网 站 的 URL 进行 管理 ( 见 @ )。 这 个 文件 的 
主体 定义 了 变量 urlpatterns( 见 @ )。 在 这 个 针对 整个 项 目的 urls.py 文件 中 ， 变 量 urlpatterns 
包含 项 目 中 应 用 程序 的 URL。@ 处 的 代码 包含 模块 admin.site.urls， 该 模块 定义 了 可 在 管理 网 
站 中 请 求 的 所 有 URL。 


我 们 需要 包含 learning logs 的 URL， 因 此 添加 如 下 代码 : 


from django.contrib import admin 
from django.urls import path, include 


urlpatterns = [ 
path('admin/', admin.site.urls), 
@ path('', include('learning logs.urls')), 
] 


在 @ 处 ,添加 一 行 代码 来 包含 模块 learning_logs.urls。 


日 


默认 的 urls.py 包含 在 文件 夹 learning_log 中 ， 现 在 需要 在 文件 夹 learning logs 中 再 创建 一 个 
urls.py 文 件 。 为 此 ， 新 建 一 个 文件 ,使 用 文件 名 urls.py 将 其 存储 到 文件 夹 learning logs 中 ， 再 在 
这 个 文件 中 输入 如 下 代码 : 


urls.py @""" 定 义 learning logs 的 URL 模式 。""" 
@ from django.urls import path 
四 from . import views 


@ app name = 'learning logs’ 
©@ urlpatterns = [ 
# 主页 
© path('', views.index, name='index'), 


] 
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为 指出 当前 位 于 哪个 urls.py 文件 中 ， 在 该 文件 开头 添加 一 个 文档 字符 串 ( 见 @ )。 接 下 来 ， 
导入 了 函数 path, 因为 需要 使 用 它 将 URL 映射 到 视图 ( 见 @ )。 我 们 还 导入 了 模块 views ( 见 @ )， 
其 中 的 句点 让 Python 从 当前 urls.py 模块 所 在 的 文件 夹 导入 views.py。 变量 app_name 让 Django 能 
够 将 这 个 urls.py 文件 同 项 目 内 其 他 应 用 程序 中 的 同名 文件 区 分 开 来 ( 见 @ )。 在 这 个 模块 中 ， 变 
量 urlpatterns 是 一 个 列表 ,包含 可 在 应 用 程序 learning_logs 中 请 求 的 页 面 。 


实际 的 URL 模式 是 对 函数 path() 的 调用 ,这 个 函数 接受 三 个 实 参 ( 见 @ ), 第 一 个 是 一 个 字 
符 串 ， 帮助 Django 正确 地 路 由 (route ) 请 求 。 收 到 请 求 的 URL 后 ，Django 力图 将 请 求 路 由 给 一 
个 视图 。 为 此 ， 它 搜索 所 有 的 URL 模式 ， 找 到 与 当前 请 求 匹配 的 那个 。Django 忽略 项 目的 基础 
URL ( http://localhost:8000/ )， 因 此 空 字符 串 ('' ) 与 基础 URL 匹配 。 其 他 URL 都 与 这 个 模式 不 
匹配 。 如 果 请 求 的 URL 与 任何 既 有 的 URL 模式 都 不 匹配 ，Django 将 返回 一 个 错误 页 面 。 


path() 的 第 二 个 实 参 ( 见 @ ) 指定 了 要 调用 view.py 中 的 哪个 函数 。 请 求 的 URL 与 前 述 正则 
表达 式 匹 配 时 ，Django 将 调用 view.py 中 的 函数 index() ( 这 个 视图 函数 将 在 下 一 节 编 写 )。 第 三 
个 实 参 将 这 个 URL 模式 的 名 称 指定 为 index, 让 我 们 能 够 在 代码 的 其 他 地 方 引用 它 。 每 当 需 要 提 
供 到 这 个 主页 的 链接 时 ， 都 将 使 用 这 个 名 称 ， 而 不 编写 URL。 


18.3.2 ”编写 视图 
视图 函数 接受 请 求 中 的 信息 , 准备 好 生成 页 面 所 需 的 数据 , 再 将 这 些 数据 发 送 给 浏览 器 一 一 
这 通常 是 使 用 定义 页 面 外 观 的 模板 实现 的 。 


learning_logs 中 的 文件 views.py 是 执行 命令 python manage.py startapp 时 自动 生成 的 ， 当 前 
其 内 容 如 下 : 


views.py from django.shortcuts import render 


# 在 这 里 创建 视图 。 


当前 ,这 个 文件 只 导入 了 函数 render(), 它 根 据 视图 提供 的 数据 演 染 响应 。 请 在 这 个 文件 中 
添加 为 主页 编写 视图 的 代码 ， 如 下 所 示 : 


from django.shortcuts import render 


def index(request): 
mem 学 习 笔 记 的 主页 。""" 
return render(request, 'learning logs/index.html') 


URL 请 求 与 刚才 定义 的 模式 匹配 时 ， Django 将 在 文件 views.py 中 查找 函数 index(), 再 将 对 
象 request 传递 给 这 个 视图 函数 。 这 里 不 需要 处 理 任 何 数据 ， 因 此 这 个 函数 只 包含 调用 render() 
的 代码 。 这 里 向 函数 render() 提 供 了 两 个 实 参 : 对 象 request 以 及 一 个 可 用 于 创建 页 面 的 模板 。 
下 面 来 编写 这 个 模板 。 
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18.3.3 ”编写 模板 


模板 定义 页 面 的 外 观 ， 而 每 当 页 面 被 请 求 时 ，Dijango 将 填 人 相关 的 数据 。 模 板 让 你 能 够 访问 
视图 提供 的 任何 数据 。 我 们 的 主页 视图 没有 提供 任何 数据 ， 因 此 相应 的 模板 非常 简单 。 


在 文件 夹 learning logs 中 新 建 一 个 文件 夹 ， 并 将 其 命名 为 templates。 在 文件 夹 templates 中 ， 
再 新 建 一 个 文件 来 ， 并 将 其 命名 为 learning_logs。 这 好 像 有 点 多 余 ( 在 文件 夹 learning logs 中 创 
建文 件 夹 ttmplates， 又 在 这 个 文件 夹 中 创建 文件 夹 learning logs )， 但 是 建立 了 Django 能 够 明确 
解读 的 结构 ， 即 便 项 目 很 大 、 包 含 很 多 应 用 程序 亦 如 此 。 在 最 里 面 的 文件 夹 learning logs 中 ,新 
建 一 个 文件 ， 并 将 其 命名 为 index.html ( 这 个 文件 的 路 径 为 learning log/learning logs/templates/ 
learning logs/index.html )， 再 在 其 中 编写 如 下 代码 : 


inadex.him| <p>Learning Log</p> 


<p>Learning Log helps you keep track of your learning, for any topic you Te 
learning about.</p> 


这 个 文件 非常 简单 。 这 里 向 不 熟悉 HTML 的 读者 解释 一 下 : 标签 cp></p> 标 识 段落 。 标签 <p> 
指出 段落 的 开头 位 置 , 而 标签 </p> 指 出 段落 的 结束 位 置 。 这 里 定义 了 两 个 段落 : 第 一 个 充当 标题 ， 
第 二 个 曾 述 了 用 户 可 使 用 “学 习 笔记 ”来 做 什么 。 

现在 ,如 果 请 求 这 个 项 目的 基础 URL http://localhost:8000/, 将 看 到 刚才 创建 的 页 面 ， 而 不 是 
默认 的 Django 页 面 。Django 接受 请 求 的 URL， 发 现 该 URL 与 模式 “匹配 ， 因 此 调用 函数 
views.index()。 这 将 使 用 index.html 包含 的 模板 来 演 染 页 面 ， 结 果 如 图 18-3 所 示 。 


©@0@ « © localhost:8000 © @ | 由 口 区 
Learning Log 


Learning Log helps you keep track of your learning, for any topic you're learning about. 


图 18-3 学习 笔 记 的 主页 


创建 页 面 的 过 程 看 起 来 可 能 很 复杂 ,但 将 URL、 视 图 和 模板 分 离 的 效果 很 好 。 这 让 我 们 能 
够 分 别 考虑 项 目的 不 同方 面 ， 在 项 目 很 大 时 ,可 让 各 个 参与 者 专注 于 最 擅长 的 方面 。 例如， 数据 
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库 专 家 专注 于 模型 ， 程 序 员 专 注 于 视图 代码 ， 而 Web 设计 人 员 专 注 于 模板 。 


注意 ”可 能 出 现 如 下 错误 消息 : 


ModuleNotFoundError: No module named 'learning logs.urls' 


如 果 确 实 如 此 ， 请 在 执行 命令 python manage.py runserver 的 终端 窗口 中 按 Ctrl + C 停 用 
服务 器 ， 再 重新 执行 这 个 命令 。 这 样 做 后 ， 应 该 能 够 看 到 主页 。 每 当 遇 到 类 似 的 错误 时 ， 
尝试 停 用 并 重启 服务 器 ， 看 看 是 否 管用 。 


动手 试 一 斌 
练习 18-5: 膳食 规划 程序 假设 你 要 创建 一 个 应 用 程序 帮助 用 户 规划 一 周 的 腾 
食 。 为 此 ， 新 建 一 个 文件 夹 ， 并 将 其 命名 为 meal planner， 再 在 这 个 文件 夹 中 新 建 一 


个 Django 项 目 。 然 后 ， 新 建 一 个 名 为 meal plans 的 应 用 程序 ， 并 为 这 个 项 目 创 建 一 
个 简单 的 主页 。 

练习 18-6: 比萨 店主 页 在 为 完成 练习 18-4 而 创建 的 项 目 Pizzeria 中 ,添加 一 个 
尘 内 ;6 


18.4 创建 其 他 页 面 


制定 创建 页 面 的 流程 后 ， 可 以 开始 扩充 “学 习 笔 记 ” 项 目 了 。 我 们 将 创建 两 个 显示 数据 的 页 
面 ， 其 中 一 个 列 出 所 有 的 主题 ， 另 一 个 显示 特定 主题 的 所 有 条 目 。 对 于 每 个 页 面 ， 我 们 都 将 指定 
URL 模式 、 编 写 一 个 视图 函数 并 编写 一 个 模板 。 但 这 样 做 之 前 ， 我 们 先 创建 一 个 父 模板 ， 项 目 
中 的 其 他 模板 都 将 继承 它 。 


18.4.1 ”模板 继承 

创建 网 站 时 , 一些 通 用 元 素 儿 乎 会 在 所 有 页 面 中 出 现 。 在 这 种 情况 下 ， 可 编写 一 个 包含 通用 
元 素 的 父 模板 , 并 让 每 个 页 面 都 继承 这 个 模板 ,而 不 必 在 每 个 页 面 中 重复 定义 这 些 通用 元 素 。 这 
种 方法 能 让 你 专注 于 开发 每 个 页 面 的 独特 方面 ， 还 能 让 修改 项 目的 整体 外 观 容易 得 多 。 


1. 父 模板 


下 面 创建 一 个 名 为 base.html 的 模板 , 并 将 其 存储 在 index.html 所 在 的 目录 中 。 这 个 模板 包含 
所 有 页 面 都 有 的 元 素 ， 而 其 他 模板 都 继承 它 。 当 前 ， 所 有 页 面 都 包含 的 元 素 只 有 项 端的 标题 。 因 
为 每 个 页 面 都 包含 这 个 模板 ， 所 以 将 这 个 标题 设置 为 到 主页 的 链接 : 
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base.himl 《py> 
© a href="{% url 'learning logs:index' %}">Learning Log</a> 
</p> 


@ {% block content %}{% endblock content %} 


这 个 文件 的 第 一 部 分 创建 一 个 包含 项 目 名 的 段落 ， 该 段落 也 是 到 主页 的 链接 。 为 创建 链接 ， 
使 用 了 一 个 模板 标签 ， 它 是 用 花 括号 和 百 分 号 〈{% %} ) 表示 的 。 模 板 标签 是 一 小 段 代 码 ， 生 成 
要 在 页 面 中 显示 的 信息 。 这 里 的 模板 标签 {% url 'learning logs:index' %} 生 成 一 个 URL， 该 
URL 与 在 learning logs/urls.py 中 定义 的 名 为 'index' 的 URL 模式 匹配 ( 见 @ )。 在 本 例 中 ， 
learning_logs 是 一 个 命名 空间 ， 而 index 是 该 命名 空间 中 一 个 名 称 独特 的 URL 模式 。 这 个 命名 
空间 来 自在 文件 learning logs/urls.py 中 赋 给 app_name 的 值 。 


在 简单 的 HTML 页 面 中 ,链接 是 使 用 锚 标 签 ca> 定 义 的 : 


<a href=" 7ink UL 371ink text</a> 


通过 使 用 模板 标签 来 生成 URL， 能 很 容易 地 确保 链接 是 最 新 的 ， 只 需 修改 urls.py 中 的 URL 
模式 ，Django 就 会 在 页 面 下 次 被 请 求 时 自动 插入 修改 后 的 URL。 在 本 项 目 中 ， 每 个 页 面 都 将 继 
承 base.html， 因 此 从 现在 开始 ， 每 个 页 面 都 包含 到 主页 的 链接 。 

在 @ 处 ,我 们 插入 了 一 对 块 标签 。 这 个 块 名 为 content， 是 一 个 占 位 符 ， 其 中 包含 的 信息 由 
子 模板 指定 。 

子 模板 并 非 必须 定义 父 模 板 中 的 每 个 块 ， 因 此 在 父 模板 中 ， 可 使 用 任意 多 个 块 来 预 留 空间 ， 
而 子 模板 可 根据 需要 定义 相应 数量 的 块 。 


注意 在 Python 代 码 中 ,几乎 总 是 缩 进 四 个 空格 。 相 比 于 Python 文件 ， 模 板 文 件 的 缩 进 层级 更 
多 ， 因 此 每 个 层级 通常 只 缩 进 两 个 空格 。 每 个 层级 缩 进 多 少 个 空格 无 关 紧 要 ， 只 需 确保 
一 致 即 可 。 


2. 子 模板 
现在 需要 重 写 index.html， 使 其 继承 base.html。 为 此 ， 向 index.html 添加 如 下 代码 : 


index.him! ©@ {% extends "learning logs/base.html" %} 


@ {% block content %} 
<p>Learning Log helps you keep track of your learning, for any topic you're 
learning about.</p> 

©@ {% endblock content %} 


如 果 将 这 些 代 码 与 原来 的 index.html 进行 比较 ， 将 发 现 标 题 Learning Log 没有 了 ， 取 而 代 之 
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的 是 指定 要 继承 哪个 模板 的 代码 ( 见 @ )。 子 模板 的 第 一 行 必须 包含 标签 {% extends %} , 让 Django 
知道 它 继承 了 哪个 父 模 板 。 文 件 base.html 位 于 文件 夹 learning logs 中 ， 因 此 父 模板 路 径 中 包含 
learning logs。 这 行 代码 导 和 人 模板 base.html 的 所 有 内 容 ， 让 index.html 能 够 指定 要 在 content 块 
预 留 的 空间 中 添加 的 内 容 。 

在 @@ 处 ， 搬 入 了 一 个 名 为 content 的 {% block %} 标 签 ， 以 定义 content 块 。 不 是 从 父 模 板 继 
承 的 内 容 都 包含 在 content 块 中 ， 在 这 里 是 一 个 描述 项 目 “ 学 习 笔记 ”的 段落 。 在 @ 处 ， 使 用 标 
签 {% endblock content %} 指 出 了 内 容 定义 的 结束 位 置 。 在 标签 {% endblock %} 中 ， 并 非 必须 指 
定 块 名 ， 但 如 果 模 板 包含 多 个 块 ， 指 定 块 名 有 助 于 确定 结束 的 是 哪个 块 。 


模板 继承 的 优点 开始 显现 出 来 了 : 在 子 模板 中 ， 只 需 包含 当前 页 面 特 有 的 内 容 。 这 不 仅 简化 
了 每 个 模板 ， 还 使 得 网 站 修改 起 来 容易 得 多 。 要 修改 很 多 页 面 都 包含 的 元 素 ， 只 需 修 改 父 模板 即 
可 ,所 做 的 修改 将 传导 到 继承 该 父 模板 的 每 个 页 面 。 在 包含 数 十 乃至 数 百 个 页 面 的 项 目 中 , 这 种 
结构 使 得 网 站 改进 起 来 更 容易 、 更 快 提 


(人 
O 


注意 在 大 型 项 目 中 ,通常 有 一 个 用 于 整个 网 站 的 父 模板 base.html， 且 网 站 的 每 个 主要 部 分 都 
有 一 个 父 模 板 。 每 个 部 分 的 父 模 板 都 继承 base.html， 而 网 站 的 每 个 页 面 都 继承 相应 部 分 
的 父 模板 。 这 让 你 能 够 轻松 地 修改 整个 网 站 的 外 观 、 网 站 任何 一 部 分 的 外 观 以 及 任何 一 
个 页 面 的 外 观 。 这 种 配置 提供 了 一 种 效率 极 高 的 工作 方式 ， 让 你 乐意 不 断 地 去 改进 网 站 。 


18.4.2 ”显示 所 有 主题 的 页 面 


有 了 高 效 的 页 面 创建 方法 ,就 能 专注 于 另外 两 个 页 面 了 : 显示 所 有 主题 的 页 面 和 显示 特定 主 
题 中 条 目的 页 面 。 前 者 显示 用 户 创 建 的 所 有 主题 ， 它 是 第 一 个 需要 使 用 数据 的 页 面 。 


1. URL 模式 

首先 ， 定义 显 示 所 有 主题 的 页 面 的 URL。 我 们 通常 使 用 一 个 简单 的 URL 片段 来 指出 页 面 显 
示 的 信息 ， 这 里 使 用 单词 topics， 因 此 URL http://localhost:8000/topics/ 将 返回 显示 所 有 主题 的 页 
面 。 下 面 演示 了 该 如 何 修改 learning logs/urls.py: 


urls.py “""" 为 learning logs 定义 URL 模式 。""" 
-- SNip-- 
urlpatterns = [ 
# 主页 
path('', views.index, name="'index'), 
# 显示 所 有 的 主题 。 
© path('topics/', views.topics, name="'topics'), 


] 


这 里 在 用 于 主页 URL 的 字符 串 参 数 中 添加 了 topics/( 见 @ )。Django 检查 请 求 的 URL 时 ， 
这 个 模式 与 如 下 URL 匹配 : 基础 URL 后 面 跟着 topics。 可 在 末尾 包含 斜 杠 ， 也 可 省 略 ， 但 单词 
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topics 后 面 不 能 有 任何 东西 ,否则 就 与 该 模式 不 匹配 URL 与 该 模式 匹配 的 请 求 都 将 交 给 views.py 
中 的 函数 topics() 处 理 。 


2. 视图 


函数 topics() 需 要 从 数据 库 中 获取 一 些 数 据 , 并 将 其 交 给 给 模板 。 需 要 在 views.py 中 添加 的 
代码 如 下 : 


views.py from django.shortcuts import render 
@ from .models import Topic 


def index(request): 
-- Snip-- 


@ def topics(request): 


""" 显 示 所 有 的 主题 。""" 

(3 topics = Topic.objects.order by('date added') 

@ context = {'topics': topics} 

© return render(request, 'learning logs/topics.html', context) 


首先 导入 与 所 需 数据 相关 联 的 模型 ( 见 @ )。 函 数 topics() 包 含 一 个 形 参 : Django 从 服务 器 
那里 收 到 的 request 对 象 ( 见 @ )。 在 日 处 ， 查 询 数 据 库 一 一 请 求 提 供 Topic 对 象 ， 并 根据 属性 
date_ added 进行 排序 。 返 回 的 查询 集 被 存储 在 topics 中 。 


在 @ 人 处， 定义 一 个 将 发 送 给 模板 的 上 下 文 。 上 下 文 是 一 个 字典 ,其 中 的 键 是 将 在 模板 中 用 来 
访问 数据 的 名 称 ， 而 值 是 要 发 送 给 模板 的 数据 。 这 里 只 有 一 个 键 值 对 ,包含 一 组 将 在 页 面 中 显示 
的 主题 。 创 建 使 用 数据 的 页 面 时 ， 除 了 对 象 request 和 模板 的 路 径 外 ， 还 将 变量 context 传递 给 
render()( 见 @ )。 


3. 模板 


显示 所 有 主题 的 页 面 的 模板 接受 字典 context， 以 便 使 用 topics() 提 供 的 数据 。 请 创建 一 个 
文件 ， 将 其 命名 为 topics.html， 并 存储 到 index.html 所 在 的 目录 中 。 下 面 演示 了 如 何在 这 个 模板 
中 显示 主题 : 


iopics.himl {% extends "learning logs/base.html" %} 
{% block content %} 
<p>Topics</p> 


<ul> 
{% for topic in topics %} 
<1i>{{ topic }}</1i> 
{% empty %} 
<li>No topics have been added yet.</1i> 


OO 
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© {% endfor %} 
@ «</ul> 


{% endblock content %} 


就 像 模 板 index.html 中 一 样 ， 首 先 使 用 标签 {% extends %} 来 继承 base.html， 再 开始 定义 
content 块 。 这 个 页 面 的 主体 是 一 个 项 目 列表 ， 其 中 列 出 了 用 户 输入 的 主题 。 在 标准 HTML 中 ， 
项 目 列表 称 为 无 序列 表 ， 用 标签 cul></ul> 表 示 。 包 含 所 有 主题 的 项 目 列表 始 于 @ 处 。 


在 @ 处 ,使 用 一 个 相当 于 for 循环 的 模板 标签 ， 它 遍历 字典 context 中 的 列表 topics。 模 板 
中 使 用 的 代码 与 Python 代码 存在 一 些 重要 差别 : Python 使 用 缩 进来 指出 哪些 代码 行 是 for 循环 
的 组 成 部 分 ;而 在 模板 中 ， 每 个 for 循环 都 必须 使 用 {% endfor %} 标 签 来 显 式 地 指出 其 结束 位 置 。 
因此 在 模板 中 ， 循 环 类 似 于 下 面 这 样 : 


{% for item in list %} 
do something with each item 
{% endfor %} 


在 循环 中 ,要 将 每 个 主题 转换 为 项 目 列表 中 的 一 项 。 要 在 模板 中 打印 变量 , 需要 将 变量 名 用 
双 花 括号 括 起 。 这 些 花 括号 不 会 出 现在 页 面 中 ,只 是 用 于 告诉 Django 我 们 使 用 了 一 个 模板 变量 。 
因此 每 次 循环 时 ，@ 处 的 代码 {{ topic }} 都 被 蔡 换 为 topic 的 当前 值 。HTML 标签 <1i></1i> 表 
示 一 个 项 目 列表 项 。 在 标签 对 <ul></ul> 内 部 ， 位 于 标签 <li> 和 </1i> 之 间 的 内 容 都 是 一 个 项 目 列 
表 项 。 

在 @ 处 ,使 用 模板 标签 {% empty %} ， 它 告诉 Django 在 列表 topics 为 空 时 该 如 何 办 。 这 里 是 
打印 一 条 消息 ， 告 诉 用 户 还 没有 添加 任何 主题 。 最 后 两 行 分 别 结 束 for 循环 ( 见 @ ) 和 项 目 列 表 
( 见 @ )。 

现在 需要 修改 父 模 板 ， 使 其 包含 到 显示 所 有 主题 的 页 面 的 链接 。 为 此 ， 在 其 中 添加 如 下 
代码 : 


base.himl! <p> 


@ «a href="{% url 'learning logs:index' %}">Learning Log</a> - 
四 «a href="{% url 'learning logs:topics' %}">Topics</a> 
</p> 


{% block content %}{% endblock content %} 


在 到 主页 的 链接 后 面 添加 一 个 连 字符 ( 见 @ ), 再 添加 一 个 到 显示 所 有 主题 的 页 面 的 链接 一 一 
使 用 的 也 是 模板 标签 {% url %}( 见 @ )。 这 行 让 Django 生成 一 个 链接 ， 它 与 learning_logs/urls.py 
中 名 为 "topics ' 的 URL 模式 匹配 。 


现在 如 果 刷 新 浏览 器 中 的 主页 ,将 看 到 链接 Topics。 如 果 单 击 这 个 链接 , 将 看 到 类 似 于 图 18-4 
所 示 的 页 面 。 
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鲍 localhost:8000/topics/ 


Oe@ . 


Learning Log - Topics 


Topics 


e Chess 
® Rock Climbing 


显示 所 有 主题 的 页 国 


图 18-4 


18.4.3 ”显示 特定 主题 的 页 面 
接 下 来 , 需要 创建 一 个 专注 于 特定 主题 的 页 面 , 它 显 示 该 主题 的 名 称 以 及 所 有 条 目 。 我 们 同 


样 将 定义 一 个 新 的 URL 模式 ， 编 写 一 个 视图 并 创建 一 个 模板 。 此 外 ， 还 将 修改 显示 所 有 主题 的 
页 面 ， 让 每 个 项 目 列表 项 都 变 为 到 相应 主题 页 面 的 链接 。 


前 面 的 所 有 URL 模式 都 稍 有 不 同 ,因为 它 使 用 主题 的 id 


1 


1. URL 模式 
显示 特定 主题 的 页 面 的 URL 模式 与 
性 来 指出 请 求 的 是 哪个 主题 。 例 如 , 如 果 用 户 要 查看 主题 Chess ( 其 id 为 1 ) 的 详细 页 面 , URL 
等 为 http://localhost:8000/topics/1/。 下 面 是 与 这 个 URL 匹配 的 模式 ， 应 将 其 放 在 learning_logs/ 


= 


可 
及 


urls.py 中 : 


-- Snip-- 
urlpatterns = [ 
-- Snip-- 
# 特定 主题 的 详细 页 面 。 
path('topics/<int:topic id>/', views.topic, name="'topic'), 


urls.py 


] 
我 们 来 详细 研究 这 个 URL 模式 中 的 字符 串 'topics/<int:topic id>/'。 这 个 字符 串 的 第 一 部 
分 让 Django 查找 在 基础 URL 后 包含 单词 topics 的 URL， 第 二 部 分 ( /<int:topic id>/ ) 与 包含 
在 两 个 斜 杠 内 的 整数 匹配 ， 并 将 这 个 整数 存储 在 一 个 名 为 topic_id 的 实 参 中 。 

发 现 URL 与 这 个 模式 匹配 时 ，Django 将 调用 视图 函数 topic()， 并 将 存储 在 topic_id 中 的 
值 作为 实 参 传递 给 它 。 在 这 个 函数 中 ， 将 使 用 topic_id 的 值 来 获取 相应 的 主题 。 


2. 视图 
函数 topic() 需 要 从 数据 库 中 获取 指定 的 主题 以 及 与 之 相关 联 的 所 有 条 目 ， 如 下 所 示 : 
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views.py --SNnip-- 
@ def topic(request, topic id): 
"" "显示 单个 主题 及 其 所 有 的 条 目 。""" 
topic = Topic.objects.get(id=topic id) 
entries = topic.entry set.order by('-date added') 
context = {'topic': topic, 'entries': entries} 
return render(request, 'learning logs/topic.html', context) 


eaoe 


文 是 除 request 对 象 外 ， 第 一 个 还 包含 另 一 个 形 参 的 视图 函数 。 这 个 函数 接受 表达 式 /<int: 
topic_id>/ 捕 获 的 值 , 并 将 其 存储 到 topic_ id 中 ( 见 @ )。 在 @ 处 , 使 用 get() 来 获取 指定 的 主题 ， 
就 像 前 面 在 Django shell 中 所 做 的 那样 。 在 @ 处 , 获取 与 该 主题 相关 联 的 条 目 , 并 根据 date_added 
进行 排序 : date_added 前 面 的 减 号 指定 按 降序 排列 ， 即 先 显示 最 近 的 条 目 。 将 主题 和 条 目 都 存储 
在 字典 context 中 ( 见 @ )， 再 将 这 个 字典 发 送 给 模板 topic.html ( 见 @ )。 


注意 ”@ 处 和 @ 处 的 代码 称 为 查询 ， 因 为 它们 向 数据 库 查询 了 特定 的 信息 。 在 自己 的 项 目 中 编 
写 这 样 的 查询 时 ， 先 在 Django shell 中 进行 尝试 大 有 神 益 。 比 起 先 编写 视图 和 模板 、 再 在 
浏览 器 中 检查 结果 ， 在 shell 中 执行 代码 可 更 快 获得 反馈 。 


3. 模板 


这 个 模板 需要 显示 主题 的 名 称 和 条 目的 内 容 。 如 果 当 前 主题 不 包含 任何 条 目 , 还 需 向 用 户 指 
出 这 一 


iopic.himl {% extends 'learning logs/base.html' %} 


{% block content %} 


<p>Topic: {{ topic }}</p> 


<p>Entries:</p> 
<ul> 
{% for entry in entries %} 
<1i> 
<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
</1i> 
{% empty %} 
<li>There are no entries for this topic yet.</1i> 
{% endfor %} 
</ul> 


{% endblock content %} 18 


像 这 个 项 目的 其 他 页 面 一 样 ， 这 里 也 继承 了 base.html。 接 下 来 ， 显 示 当 前 的 主题 ( 见 @ )， 它 
存储 在 模板 变量 {{ topic }} 中 。 为 什么 可 以 使 用 变量 topic 呢 ? 因为 它 包含 在 字典 context 中 。 接 
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下 来 ,定义 一 个 显示 每 个 条 目的 项 目 列表 ( 见 @ )， 并 像 前 面 显 示 所 有 主题 一 样 遍历 条 目 ( 见 @ )。 


每 个 项 目 列 表 项 都 将 列 出 两 项 信息 : 条 目的 时 间 蕉 和 完整 的 文本 。 为 列 出 时 间 戳 ( 见 @ )， 
我 们 显示 属性 date_added 的 值 。 在 Django 模板 中 , 竖 线 ( | ) 表示 模板 过 滤器 ， 即 对 模板 变量 的 
值 进 行 修改 的 函数 。 过 滤器 date: 'M d, YH:i' 以 类 似 于 这 样 的 格式 显示 时 间 惟 : January 1, 2018 
23:00。 接 下 来 的 一 行 显示 text 的 完整 值 ， 而 不 仅仅 是 前 50 字符 。 过 滤器 linebreaks ( 见 @ ) 将 
包含 换行 符 的 长 条 目 转换 为 浏览 器 能 够 理解 的 格式 ， 以 免 显示 为 不 间断 的 文本 块 。 在 @ 处 ,使 用 
模板 标签 {% empty %} 打 印 一 条 消息 ， 告 诉 用 户 当前 主题 还 没有 条 目 。 


4. 将 显示 所 有 主题 的 页 面 中 的 主题 设置 为 链接 


在 浏览 器 中 查看 显示 特定 主题 的 页 面前 ， 需 要 修改 模板 topics.html， 让 每 个 主题 都 链接 到 相 
应 的 页 面 ， 如 下 所 示 : 


topics.himl  -- Ss/1p-- 
{% for topic in topics %} 
<1i> 
<a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a> 
</1i> 
{% empty %} 
-- Snip-- 


我 们 使 用 模板 标签 url 根据 learning logs 中 名 为 'topic' 的 URL 模式 生成 了 合适 的 链接 。 
这 个 URL 模式 要 求 提供 实 参 topic_id， 因 此 在 模板 标签 url 中 添加 了 属性 topic.id。 现 在 ， 主 
题 列表 中 的 每 个 主题 都 是 链接 了 ,链接 到 显示 相应 主题 的 页 面 ， 如 http://localhost:8000/topics/1/。 


如 果 现在 刷新 显示 所 有 主题 的 页 面 ， 再 单 击 其 中 的 一 个 主题 ， 将 看 到 类 似 于 图 18-5 所 示 的 
页 面 。 


@@e@ « 团 ® localhost:8000/topics/1/ & © 


[eg 
[el 


Learning Log - Topics 
Topic: Chess 
Entries: 

® Feb19,201902:06 


In the opening phase of the game, it's important to bring out your bishops and knights. These pieces are powerful and 
maneuverable enough to play a significant role in the beginning moves of a game. 


® Feb 19,2019 02:06 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it’s a good idea to do three 
things—bring out your bishops and knights, try to control the center of the board, and castle your king. 


Of course, these are just guidelines. It will be important to learn when to follow these guidelines and when to disregard 
these suggestions. 


图 18-5 特定 主题 的 详细 页 面 ， 其 中 显示 了 该 主题 的 所 有 条 目 
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注意 topic.id 和 topic id 之 间 存 在 细微 而 重要 的 差别 。 表达 式 topic.id 检查 主题 并 获取 其 ID 值 ， 
而 在 代码 中 ,变量 topic id 是 指向 该 ID 的 引用 。 使 用 ID 时 如 果 出 现 错误 , 请 确保 正确 地 
使 用 了 这 两 个 表达 式 。 


动手 试 一 斌 
练习 18-7: 模板 文档 ”请 浏览 Django 模板 文档 。 自 己 开发 项 目 时 ， 你 可 再 回 过 头 
来 参考 该 文档 。 


练习 18-8: 比萨 店 页 面 在 练习 18-6 中 开发 的 项 目 Pizzeria 中 ， 添 加 一 个 页 面 来 
显示 供应 的 比萨 的 名 称 。 然 后 ， 将 每 个 比萨 名 都 设置 成 链接 ， 可 通过 单 击 来 显示 一 个 列 
出 相应 配料 的 页 面 。 请 务必 使 用 模板 继承 来 高 效 地 创建 页 面 。 


18.5 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 Django 框架 来 创建 Web 应 用 程序 ; 制定 简要 的 项 目 规范 ， 
在 虚拟 环境 中 安装 Django， 创 建 一 个 项 目 ， 并 核实 该 项 目 已 被 正确 地 创建 ; 如 何 创 建 应 用 程序 ， 
以 及 如 何 定义 表示 应 用 程序 数据 的 模型 。 你 了 解 了 数据 库 , 以 及 在 修改 模型 后 , Django 可 为 迁移 
数据 库 提供 什么 帮助 。 你 创建 了 可 访问 管理 网 站 的 超级 用 户 ， 并 使 用 管理 网 站 输入 了 一 些 初始 
数据 。 


你 还 探索 了 Django shell， 它 让 你 能 够 在 终端 会 话 中 处 理 项 目的 数据 。 你 学 习 了 如 何 定义 
URL、 创建 视图 函数 以 及 编写 为 网 站 创建 页 面 的 模板 。 最 后 ,你 使 用 模板 继承 简化 了 各 个 模板 的 
结构 ， 使 修改 网 站 变 得 更 容易 。 

第 19 章 将 创建 对 用 户 友好 而 直观 的 页 面 ， 让 用 户 无 须 通 过 管理 网 站 就 能 添加 新 的 主题 和 条 
目 , 以 及 编辑 既 有 条 目 。 我 们 还 将 添加 一 个 用 户 注册 系统 ， 让 用 户 能 够 创建 账户 并 记录 自己 的 学 
习 笔 记 。Web 应 用 程序 的 核心 就 是 ， 让 任意 数量 的 用 户 都 能 与 之 交互 。 


用 户 账 户 


Web 应 用 程序 的 核心 是 让 任何 用 户 都 能 够 注册 账户 并 能 够 使 用 
它 ， 不 管用 户 身 处 何方 。 在 本 章 中 ,我 们 将 创建 一 些 表单 ， 让 用 户 能 
够 添加 主题 和 条 目 ， 以 及 编辑 既 有 的 条 目 。 我 们 还 将 学 习 Django 如 
何 防范 对 基于 表单 的 页 面 发 起 的 常见 攻击 ,从 而 无 须 花 太 多 时 间 考 虑 
确保 应 用 程序 安全 的 问题 。 


然后 ,我 们 将 实现 一 个 用 户 身份 验证 系统 。 首 先 创建 一 个 注册 页 面 ， 供 用 户 创建 账户 ,并 让 
有 些 页 面 只 能 供 已 登录 的 用 户 访问 。 接 下 来 , 修改 一 些 视图 函数 , 使 得 用 户 只 能 看 到 自己 的 数据 。 
我 们 还 将 学 习 如 何 确保 用 户 数据 的 安全 。 


19.1 让 用 户 输入 数据 
建立 用 于 创建 用 户 账户 的 身份 验证 系统 之 前 , 我们 先 来 添加 几 个 页 面 ,让 用 户 能 够 输入 数据 。 
我 们 将 让 用 户 添 加 新 主题 ， 添 加 新 条 目 以 及 编辑 既 有 条 日。 


当前 ， 只 有 超级 用 户 能 够 通过 管理 网 站 输入 数据 。 我 们 不 想 让 用 户 与 管理 网 站 交互 ， 因 此 我 
们 将 使 用 Django 的 表单 创建 工具 来 创建 让 用 户 能 够 输入 数据 的 页 面 。 


19.1.1 添加 新 主题 


首先 来 让 用 户 能 够 添加 新 主题 。 创 建 基于 表单 的 页 面 的 方法 几乎 与 前 面 创建 页 面 一 样 : 定义 
URL， 编 写 视图 函数 并 编写 一 个 模板 。 一 个 主要 差别 是 ， 需 要 导入 包含 表单 的 模块 forms.py。 


1. 用 于 添加 主题 的 表单 
让 用 户 输 入 并 提交 信息 的 页 面 都 是 表单 ， 哪 怕 看 起 来 不 像 。 用 户 输入 信息 时 , 我 们 需要 进行 
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验证 ， 确 认 提供 的 信息 是 正确 的 数据 类 型 ， 而 不 是 恶意 的 信息 ， 如 中 断 服务 器 的 代码 。 然 后 ， 对 
这 些 有 效 信息 进行 处 理 ， 并 将 其 保存 到 数据 库 的 合适 地 方 。 这 些 工作 很 多 都 是 由 Django 自动 完 
成 的 。 

在 Diango 中 ， 创 建 表单 的 最 简单 方式 是 使 用 ModelForm， 它 根据 我 们 在 第 18 章 定义 的 模型 
中 的 信息 自动 创建 表单 。 请 创建 一 个 名 为 forms.py 的 文件 ， 将 其 存储 到 models.py 所 在 的 目录 ， 
并 在 其 中 编写 你 的 第 一 个 表单 : 


forms.py from django import forms 
from .models import Topic 


@ class TopicForm(forms.ModelForm): 


class Meta: 
© model = Topic 
(3 fields = ['text'] 
@ labels = {'text': ''} 


首先 导入 模块 forms 以 及 要 使 用 的 模型 Topic。 在 @ 处 , 定义 一 个 名 为 TopicForm 的 类 , 它 继 
承 了 forms.ModeLForm。 

最 简单 的 ModelForm 版 本 只 包含 一 个 内 般 的 Meta 类 ， 它 告诉 Django 根据 哪个 模型 创建 表单 
以 及 在 表单 中 包含 哪些 字段 。 在 @ 人 处 ， 根 据 模型 Topic 创建 表单 ， 其 中 只 包含 字段 text ( 见 @ )。 
@ 处 的 代码 让 Django 不 要 为 字段 text 生成 标签 。 

2. URL 模式 new_topic 


新 页 面 的 URL 应 简短 旦 具有 描述 性 ， 因 此 当 用 户 要 添加 新 主题 时 ,我 们 切换 到 http://localhost: 
8000/new_topic/。 下 面 是 页 面 new_topic 的 URL 模式 ， 请 将 其 添加 到 learning logs/ urls.py 中 : 


urls.py --Snip-- 
urlpatterns = [ 
-- Snip-- 
# 用 于 添加 新 主题 的 页 面 。 
path('new topic/', views.new topic, name='new topic'), 


] 


这 个 URL 模式 将 请 求 交 给 视图 函数 new_topic()， 下 面 来 编写 这 个 函数 。 


3. 视图 函数 new_topic() 
函数 new_topic() 需 要 处 理 两 种 情形 。 一 是 刚 进 入 new_topic 页 面 (在 这 种 情况 下 应 显示 
表单 ); 二 是 对 提交 的 表单 数据 进行 处 理 ， 并 将 用 户 重 定向 到 页 面 topics: 


| 
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views.py from django.shortcuts import render, redirect 


from .models import Topic 
from .forms import TopicForm 


-- Snip-- 
def new topic(request): 
if request.method != 'POST': 
# 未 提交 数据 : 创建 一 个 新 表单 。 
form = TopicForm() 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
form = TopicForm(data=request.POST) 
if form.is valid(): 
form. save() 
return redirect('learning logs:topics') 


® 


@O@@OOO 


# 显示 空 表单 或 指出 表单 数据 无 效 。 
context = {'form': form} 
return render(request, 'learning logs/new topic.html', context) 


@ 


我 们 导入 了 函数 redirect ， 用 户 提交 主题 后 将 使 用 这 个 函数 重 定向 到 页 面 topics。 函 数 
redirect 将 视图 名 作为 参数 , 并 将 用 户 重 定向 到 这 个 视图 。 我 们 还 导入 了 刚 创建 的 表单 TopicForm。 


4. GET 请 求 和 POST 请 求 

创建 Web 应 用 程序 时 ， 将 用 到 的 两 种 主要 请 求 类 型 是 GET 请 求 和 POST 请 求 。 对 于 只 是 从 
服务 器 读 取 数据 的 页 面 ， 使 用 GET 请 求 ; 在 用 户 需要 通过 表单 提交 信息 时 ， 通 常 使 用 POST 请 
求 。 处 理 所 有 表单 时 , 都 将 指定 使 用 POST 方法 。 还 有 一 些 其 他 类 型 的 请 求 , 但 本 项 目 没 有 使 用 。 

函数 new_topic() 将 请 求 对 象 作 为 参数 ,用户 初 次 请 求 该 页 面 时 , 其 浏览 器 将 发 送 GET 请 求 ; 
用 户 填 写 并 提交 表单 时 ， 其 浏览 器 将 发 送 POST 请 求 。 根 据 请 求 的 类 型 ， 可 确定 用 户 请 求 的 是 空 
表单 (GET 请求 ) 还 是 要 求 对 填写 好 的 表单 进行 处 理 (POST 请 求 )。 

@ 处 的 测试 确定 请 求 方法 是 GET 还 是 POST。 如 果 请 求 方法 不 是 POST, 请 求 就 可 能 是 GET， 
因此 需要 返回 一 个 空 表单 。( 即便 请 求 是 其 他 类 型 的 , 返回 空 表单 也 不 会 有 任何 问题 。) @ 处 创建 
一 个 TopicForm 实例 ， 将 其 赋 给 变量 form， 再 通过 上 下 文字 典 将 这 个 表单 发 送 给 模板 ( 见 @ )。 
于 实例 化 TopicForm 时 没有 指定 任何 实 参 ，Django 将 创建 一 个 空 表单 ， 供 用 户 填写 。 

如 果 请 求 方法 为 POST, 将 执行 else 代码 块 , 对 提交 的 表单 数据 进行 处 理 。 我 们 使 用 用 户 输 
入 的 数据 (存储 在 request.P0ST 中 ) 创建 一 个 TopicForm 实例 ( 见 @ )， 这 样 对 象 form 将 包含 用 
户 提 交 的 信息 。 

要 将 提交 的 信息 保存 到 数据 库 , 必须 先 通 过 检查 确定 它们 是 有 效 的 ( 见 @ ), 方法 is_valid() 
核实 用 户 填写 了 所 有 必 不 可 少 的 字段 (表单 字段 默认 都 是 必 不 可 少 的 )， 且 输入 的 数据 与 要 求 的 
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字段 类 型 一 至 ( 例如， 字段 text 少 于 200 字符 ， 这 是 第 18 章 在 models.py 中 指定 的 )。 这 种 自动 
验证 避免 了 我 们 去 做 大 量 的 工作 。 如 果 所 有 字段 都 有 效 ， 就 可 调用 save() ( 见 日 )， 将 表单 中 的 
数据 写 人 数据 库 。 


保存 数据 后 ， 就 可 离开 这 个 页 面 了 。 为 此 ,使 用 redirect() 将 用 户 的 浏览 器 重 定向 到 页 面 
topics( 见 @ )。 在 页 面 topics 中 ,用 户 将 在 主题 列表 中 看 到 他 刚 输入 的 主题 。 


我 们 在 这 个 视图 函数 的 末尾 定义 了 变量 context， 并 使 用 稍 后 将 创建 的 模板 new_topic.html 
来 泻 染 页 面 。 这 些 代码 不 在 if 代码 块 内 ， 因 此 无 论 是 用 户 刚 进入 new_topic 页 面 还 是 提交 的 表 
单数 据 无 效 ， 这 些 代 码 都 将 执行 。 用 户 提交 的 表单 数据 无 效 时 ,将 显示 一 些 默认 的 错误 消息 ， 帮 
助 用 户 提供 有 效 的 数据 。 


5. 模板 new_topic 
下 面 来 创建 新 模板 new_topic.html， 用 于 显示 刚 创 建 的 表单 : 


new topic.him! {% extends "learning logs/base.html" %} 


{% block content %} 
<p>Add a new topic:</p> 


<form action="{% url 'learning logs:new topic' %}" method='post'> 
{% csrf token %} 
{{ form.as p }} 
<button name="submit">Add topic</button> 

</form> 


OO 


{% endblock content %} 


这 个 模板 继承 了 base.html， 因 此 其 基本 结构 与 项 目 “ 学 习 笔记 ”的 其 他 页 面相 同 。 在 @ 处 ， 
定义 了 一 个 HTML 表单 。 实 参 action 告诉 服务 器 将 提交 的 表单 数据 发 送 到 哪里 。 这 里 将 它 发 回 
给 视图 函数 new_topic()。 实 参 method 让 浏览 器 以 POST 请 求 的 方式 提交 数据 。 

Django 使 用 模板 标签 {% csrf token %}( 见 @ ) 来 防止 攻击 者 利用 表单 来 获得 对 服务 器 未 经 
授权 的 访问 (这 种 攻击 称 为 跨 站 请 求 伪造 )、@ 处 显示 表单 ， 从 中 可 知 Django 使 得 完成 显示 表单 
等 任务 有 多 简单 : 只 需 包 含 模板 变量 {{ form.as_p }}， 就 可 让 Django 自动 创建 显示 表单 所 需 的 
全 部 字段 。 修 饰 符 as_p 让 Django 以 段落 格式 泻 染 所 有 表单 元 素 ， 这 是 一 种 整洁 地 显示 表单 的 简 
单方 式 。 


Django 不 会 为 表单 创建 提交 按钮 ， 因 此 我 们 在 @ 处 定义 了 一 个 。 
6. 链接 到 页 面 new_topic 
下 面 在 页 面 topics 中 添加 到 页 面 new_topic 的 链接 : 


374 第 19 章 用 户 账 户 


topics.himl {% extends "learning logs/base.html" %} 
{% block content %} 
<p>Topics</p> 
<U]> 
--517]-- 


</ul> 


<a href="{% url 'learning logs:new topic' %}">Add a new topic</a> 


{% endblock content %} 


这 个 链接 放 在 既 有 主题 列表 的 后 面 。 图 19-1 显示 了 生成 的 表单 。 请 使 用 这 个 表单 来 添加 几 
个 新 主题 。 


OO@ « E 鸟 localhost:8000/new topic/ 二 © 咎 器 


Learning Log - Topics 


Add a new topic: 


Add topic 


图 19-1 用 于 添加 新 主题 的 页 面 


19.1.2 ”添加 新 条 目 


可 以 添加 新 主题 之 后 ， 用 户 还 会 想 添加 几 个 新 条 目 。 我 们 将 再 次 定义 URL， 编 写 视图 函数 
和 模板 ， 并 且 链 接 到 添加 新 条 目的 页 面 。 但 在 此 之 前 ， 需 要 在 forms.py 中 再 添加 一 个 类 。 


1. 用 于 添加 新 条 目的 表单 
我 们 需要 创建 一 个 与 模型 Entry 相关 联 的 表单 ， 但 这 个 表单 的 定制 程度 比 TopicForm 更 高 一 些 : 


forms.py from django import forms 


from .models import Topic, Entry 
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class TopicForm(forms.ModelForm): 
-- Snip-- 


class EntryForm(forms.ModelForm): 
class Meta: 

model = Entry 

fields = ['text'] 

© labels = {'text': ' '} 

© widgets = {'text': forms.Textarea(attrs={'cols': 80})} 


首先 修改 import 语句 ， 使 其 除 导 入 Topic 外 ， 还 导入 Entry。 新 类 EntryForm 继承 了 forms. 
ModelForm， 它 包含 的 Meta 类 指出 了 表单 基于 的 模型 以 及 要 在 表单 中 包含 哪些 字段 。 这 里 给 字段 
'text ' 指定 了 标签 'Entry: ( 见 @ )。 


在 @ 处 ， 我 们 定义 了 属性 widgets。 小 部 件 (widget ) 是 一 个 HTML 表单 元 素 ， 如 单行 文本 
框 、 多 行文 本 区 域 或 下 拉 列 表 。 通 过 设置 属性 widgets， 可 覆盖 Django 选择 的 默认 小 部 件 。 通 过 
让 Django 使 用 forms .Textarea, 我 们 定制 了 字段 'text ' 的 输入 小 部 件 , 将 文本 区 域 的 宽度 设置 为 
80 列 ， 而 不 是 默认 的 40 列 。 这 给 用 户 提供 了 足够 的 空间 来 编写 有 意义 的 条 目 。 


2. URL 模式 new_entry 


在 用 于 添加 新 条 目的 页 面 的 URL 模式 中 ， 需 要 包含 实 参 topic_id， 因 为 条 目 必 须 与 特定 的 
主题 相关 联 。 该 URL 模式 如 下 ， 请 将 它 添 加 到 learning logs/urls.py 中 : 


urls.py --Snip-- 
urlpatterns = [ 
-- Snip-- 
# 用 于 添加 新 条 目的 页 面 。 
path('new entry/<int:topic id>/', views.new entry, name='new entry'), 


] 


这 个 URL 模式 与 形 如 http://1localhost:8000/new entry/id/ 的 URL 匹配 ， 其 中 的 i4 是 一 
个 与 主题 ID 匹配 的 数 。 代 码 <int:topic_ id> 捕 获 一 个 数值 ， 并 将 其 赋 给 变量 topic id。 请 求 的 
URL 与 这 个 模式 匹配 时 ，Django 将 请 求 和 主题 ID 发 送 给 函数 new_entry()。 


3. 视图 函数 new_entry() 
视图 函数 new_entty() 与 函数 new_topic() 很 像 ， 请 在 views.py 中 添加 如 下 代码 : 


views.py from django.shortcuts import render, redirect 


from .models import Topic 
from .forms import TopicForm, EntryForm 


-- Snip-- 
def new entry(request, topic id): 


""" 在 特定 主题 中 添加 新 条 目 。""" 
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@ topic = Topic.objects.get(id=topic id) 


© if request.method != 'POST': 
# 未 提交 数据 : 创建 一 个 空 表单 。 
(3 form = EntryForm() 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
form = EntryForm(data=request.POST) 
if form.is valid(): 
new entry = form.save(commit=False) 
new entry.topic = topic 
new_entry.save() 
return redirect('learning logs:topic', topic id=topic id) 


@ 9go © 


# 显示 空 表单 或 指出 表单 数据 无 效 。 
context = {'topic': topic, 'form': form} 
return render(request, 'learning logs/new entry.html', context) 


~ 


我 们 修改 import 语句 ， 在 其 中 包含 刚 创 建 的 EntryForm。new_entry() 的 定义 包含 形 参 
topic_ id， 用 于 存储 从 URL 中 获得 的 值 。 泻 染 页 面 和 处 理 表单 数据 时 ， 都 需要 知道 针对 的 是 哪 


个 主题 ， 因 此 使 用 topic_id 来 获得 正确 的 主题 ( 见 @ )。 


在 @ 处 ,检查 请 求 方法 是 POST 还 是 GET。 如 果 是 GET 请 求 ， 就 执行 if 代码 块 ， 创 建 一 个 
空 的 EntryForm 实例 ( 见 @ )。 如 果 请 求 方法 为 POST， 就 对 数据 进行 处 理 : 创建 一 个 EntryForm 
实例 ， 使 用 request 对 象 中 的 POST 数据 来 填充 它 〈 见 @ )。 然 后 检查 表单 是 否 有 效 。 如 果 有 效 ， 
就 设置 条 目 对 象 的 属性 topic， 再 将 条 目 对 象 保存 到 数据 库 。 


调用 save() 时 ， 传 递 实 参 commit=False ( 见 日 )， 让 Django 创建 一 个 新 的 条 目 对 象 ， 并 将 其 
赋 给 new_entry, 但 不 保存 到 数据 库 中 。 将 new_entry 的 属性 topic 设置 为 在 这 个 函数 开头 从 数据 
库 中 获取 的 主题 ( 见 @ )， 再 调用 save() 且 不 指定 任何 实 参 。 这 将 把 条 目 保存 到 数据 库 ， 并 将 其 
与 正确 的 主题 相关 联 。 

在 @ 处 , 调用 redirect(), 它 要 求 提供 两 个 参数 : 要 重 定向 到 的 视图 和 要 给 视图 函数 提供 的 
参数 。 这 里 重 定向 到 topic()， 而 这 个 视图 函数 需要 参数 topic_id。 视 图 函数 topic() 泻 染 新 增 
条 目 所 属 主 题 的 页 面 ， 其 中 的 条 目 列 表 包 含 新 增 的 条 目 。 

在 视图 函数 new_entry() 的 末尾 ， 我 们 创建 了 一 个 上 下 文字 典 ， 并 使 用 模板 new_entry.html 
演 染 页 面 。 这 些 代码 将 在 用 户 刚 进入 页 面 或 提交 的 表单 数据 无 效 时 执行 。 


NS 


I 


4. 模板 new_entry 
模板 new_entry 类 似 于 模板 new_topic， 如 下 面 的 代码 所 示 : 


new_enfryhim| {% extends "learning logs/base.html" %} 


{% block content %} 
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@ “pa href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a></p> 


<p>Add a new entry:</p> 
四 <form action="{% url 'learning logs:new entry' topic.id %}" method="'post'> 
{% csrf token %} 
{{ form.as p }} 
<button name= submit'>Add entry</button> 
</form> 


{% endblock content %} 


在 页 面 顶 端 显示 主题 ( 见 @ )， 让 用 户 知道 自己 是 在 哪个 主题 中 添加 条 目 。 该 主题 名 也 是 一 
个 链接 ， 可 用 于 返回 到 该 主题 的 主页 面 。 


表单 的 实 参 action 包含 URL 中 的 topic_ id 值 ,让 视图 函数 能 够 将 新 条 目 关 联 到 正确 的 主题 
( 见 @ )。 除 此 之 外 ， 这 个 模板 与 模板 new_topic.html 完全 相同 。 


5. 链接 到 页 面 new_entry 
接 下 来 ， 需 要 在 显示 特定 主题 的 页 面 中 添加 到 页 面 new_entry 的 链接 : 


topic.him! {% extends "learning logs/base.html" %} 
{% block content %} 
<p>Topic: {{ topic }}</p> 
<p>Entries:</p> 
<p> 
<a href="{% url 'learning logs:new entry' topic.id %}">Add new entry</a> 
</p> 
<U]> 
-- Snip-- 


</U]> 


{% endblock content %} 


我 们 将 这 个 链接 放 在 条 目 列 表 前 面 , 因为 在 这 种 页 面 中 , 执行 的 最 常见 的 操作 是 添加 新 条 目 。 
图 19-2 显示 了 页 面 new_entry。 现在 用 户 可 添加 新 主题 , 还 可 在 每 个 主题 中 添加 任意 数量 的 条 目 。 
请 在 一 些 主题 中 添加 新 条 目 ， 尝 试 使 用 一 下 页 面 new_entry。 
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@ < L 


@B localhost:8000/new_entry/1/ © © 
Learning Log - Topics 
Chess 


Add a new entry: 


The bishops and knights are good pieces to have out in the opening phase of the game. They're both 


powerful enough to be useful in attacking your opponent, but not so powerful that you can't afford to lose 
them in an early trade. 


Add entry 


图 19-2 页 面 new_entry 


19.1.3 ”编辑 条 目 
下 面 来 创建 让 用 户 能 够 编辑 既 有 条 目的 页 面 。 


1. URL 模式 edit_entry 


这 个 页 面 的 URL 需要 传递 要 编辑 的 条 目的 ID。 修 改 后 的 learning logs/urls.py 如 下 : 


urls.py --SNnip-- 
urlpatterns = [ 
-= Snip-- 
# 用 于 编辑 条 目的 页 面 。 
path('edit entry/<int:entry id>/', views.edit entry, name='edit entry'), 


] 


在 URL (如 http://localhost:8000/edit entry/1/ ) 中 传递 的 ID 存储 在 形 参 entry id 中 。 这 个 
URL 模式 将 与 其 匹配 的 请 求 发 送 给 视图 函数 edit_entry()。 


2. 视图 函数 edit_entry() 


页 面 edit_entry 收 到 GET 请 求 时 ，edit_entry() 将 返回 一 个 表单 ， 让 用 户 能 够 对 条 目 进 行 
编辑 ; 收 到 POST 请 求 (条目 文本 经 过 修订 ) 时 ， 则 将 修改 后 的 文本 保存 到 数据 库 : 


views. from django.shortcuts import render, redirect 
py 


from .models import Topic, Entry 
from .forms import TopicForm, EntryForm 
-- Snip-- 


19.1 让 用 户 输 入 数据 379 


def edit entry(request, entry jid) : 
mn 编辑 既 有 条 目 。""" 
© entry = Entry.objects.get(id=entry id) 
topic = entry.topic 


if request.method != 'POST': 
# 初次 请 求 : 使 用 当前 条 目 填充 表单 。 


© form = EntryForm(instance=entry) 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
上 form = EntryForm(instance=entry, data=request.POST) 


if form.is valid(): 
form. save() 
return redirect('learning logs:topic', topic id=topic.id) 


@e 


context = {'entry': entry, 'topic': topic, "form' : form} 
return render(request, 'learning logs/edit entry.html', context) 


首先 导入 模型 Entry。 在 @ 处 ， 获 取 用 户 要 修改 的 条 目 对 象 以 及 与 其 相关 联 的 主题 。 在 请 求 
方法 为 GET 时 将 执行 的 if 代码 块 中 ,使 用 实 参 ijnstance=entry 创建 一 个 EntryForm 实例 ( 见 @ )。 
这 个 实 参 让 Django 创建 一 个 表单 ， 并 使 用 既 有 条 目 对 象 中 的 信息 填充 它 。 用 户 将 看 到 既 有 的 数 
据 ， 并 且 能 够 编辑 。 

处 理 POST 请 求 时 , 传递 实 参 instance=entry 和 data=request.P0ST( 见 @ ), 让 Django 根据 
既 有 条 目 对 象 创建 一 个 表单 实例 ， 并 根据 request.P0ST 中 的 相关 数据 对 其 进行 修改 。 然 后 ， 检 
查 表单 是 否 有 效 。 如 果 有 效 ， 就 调用 save() 且 不 指定 任何 实 参 ( 见 @ )， 因 为 条 目 已 关联 到 特定 
的 主题 。 然 后 ， 重 定向 到 显示 条 目 所 属 主题 的 页 面 ( 见 @ )， 用 户 将 在 其 中 看 到 其 编辑 的 条 目的 
新 版 本 。 


如 果 要 显示 表单 让 用 户 编辑 条 目 或 者 用 户 提 交 的 表单 无 效 ， 就 创建 上 下 文字 典 并 使 用 模板 
edit_entry.html 演 染 页 面 。 


3. 模板 edit_entry 
下 面 来 创建 模板 edit_entry.html， 它 与 模板 new_entry.html 类 似 : 


edit_ eniryhim! {% extends "learning logs/base.html" %} 
{% block content %} 
<p><a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a></p> 


<p>Edit entry:</p> 


@ “form action="{% url 'learning logs:edit entry' entry.id %}" method="'post'> 
{% csrf token %} 
{{ form.as p }} 
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@ <button name="submit">Save changes</button> 
</form> 


{% endblock content %} 


在 @ 处 ， 实 参 action 将 表单 发 送 给 函数 edit_entry() 处 理 。 在 标签 {% url %} 中 ， 将 条 目 ID 
作为 一 个 实 参 ,让 视图 函数 edit_entry() 能 够 修改 正确 的 条 目 对 象 。 在 @ 处 ,将 提交 按钮 的 标签 
设置 成 Save changes， 旨 在 提醒 用 户 : 单 击 该 按钮 将 保存 所 做 的 编辑 ， 而 不 是 创建 一 个 新 条 目 。 

4. 链接 到 页 面 edit_entry 

现在 ， 需 要 在 显示 特定 主题 的 页 面 中 给 每 个 条 目 添加 到 页 面 edit_entry 的 链接 : 


topic.himl -- snip-- 
{% for entry in entries %} 
<1i> 
<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
<p> 
<a href="{% url 'learning logs:edit entry' entry.id %}">Edit entry</a> 
</p> 
/LY 
--SNnip-- 


将 编辑 链接 放 在 了 每 个 条 目的 日 期 和 文本 后 面 。 在 循环 中 , 使 用 模板 标签 {% url %} 根 据 URL 
模式 edit_entry 和 当前 条 目的 ID 属性 (entry.id ) 来 确定 URL。 链 接 文本 为 Editentry， 它 出 现 
在 页 面 中 每 个 条 目的 后 面 。 图 19-3 显示 了 包含 这 些 链 接 时 ， 显 示 特 定 主题 的 页 面 是 什么 样 的 。 


@ (ER< 鸟 localhost:8000/topics/1/ lg © 由 器 


| 


| 二 6 
Topic: Chess 
Entries: 
Add new entry 
e Feb 19, 2019 07:07 
The bishops and knights are good pieces to have out in the opening phase of the game. They're both powerful 
enough to be useful in attacking your opponent, but not so powerful that you can't afford to lose them in an 


early trade. 


Edit entry 


e Feb 19,2019 02:06 


In the opening phase of the game, it’s important to bring out your bishops and knights. These pieces are 
powerful and maneuverable enough to play a significant role in the beginning moves of a game. 


Edit entry 
e Feb 19,2019 02:06 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it’s a good idea to 
do three things— bring out your bishops and knights, try to control the center of the board, and castle your 


图 19-3 ”每 个 条 目 都 有 一 个 用 于 编辑 的 链接 
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至 此 ,“ 学 习 笔 记 ” 已 具备 了 需要 的 大 部 分 功能 。 用 户 可 添加 主题 和 条 目 ， 还 可 根据 需要 查 
看 任何 条 目 。 在 下 一 节 , 我 们 将 实现 一 个 用 户 注册 系统 , 让 任何 人 都 可 向 “学 习 笔 记 ” 申 请 账户 ， 
并 创建 自己 的 主题 和 条 目 。 


动手 试 一 斌 
练习 19-1: 博客 新 建 一 个 Django 项目， 将 其 命名 为 Blog。 在 这 个 项 目 中 ,创建 
一 个 名 为 blogs 的 应 用 程序 , 并 在 其 中 创建 一 个 名 为 BlogPost 的 模型 。 这 个 模型 应 包含 


title、text 和 date_added 等 字段 。 为 这 个 项 目 创建 一 个 超级 用 户 ， 并 使 用 管理 网 站 创 
建 几 个 简短 的 帖子 。 创 建 一 个 主页 ， 在 其 中 按时 间 顺 序 显示 所 有 的 帖子 。 

创建 两 个 表单 ， 其 中 一 个 用 于 发 布 新 帖子 , 另 一 个 用 于 编辑 既 有 的 帖子 。 尝 试 填写 
这 些 表 单 ， 确 认 它 们 能 够 正确 工作 。 
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本 节 将 建立 用 户 注册 和 身份 验证 系统 ， 让 用 户 能 够 注册 账户 ,进而 登录 和 注销 。 为 此 ,我们 
将 新 建 一 个 应 用 程序 ， 其 中 包含 与 处 理 用 户 账户 相关 的 所 有 功能 。 这 个 应 用 程序 将 尽 可 能 使 用 
Django 自 带 的 用 户 身 份 验证 系统 来 完成 工作 。 本 节 还 将 对 模型 Topic 稍 做 修改 , 让 每 个 主题 都 归 
属于 特定 用 户 。 


19.2.1 应 用 程序 users 
首先 使 用 命令 startapp 创建 一 个 名 为 users 的 应 用 程序 : 


(11 env)learning log$ python manage.py startapp users 
(11 env)learning log$ 1s 
@ db.sqlite3 learning log learning logs 1]1 env manage.py users 
(11 env)learning log$ ls users 
@ init .py admin.py apps.py migrations models.py tests.py views.py 


这 个 命令 新 建 一 个 名 为 users 的 目录 ( 见 @ ), 其 结构 与 应 用 程序 learning logs 相同 ( 见 @ )。 


19.2.2 ”将 users 添加 到 settings.py 中 
在 settings.py 中 ， 需 要 将 这 个 新 的 应 用 程序 添加 到 INSTALLED_APPS 中 ， 如 下 所 示 : 


settings.py  --51ITD-- 


INSTALLED APPS = [ 
# 我 的 应 用 程序 
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'learning logs', 
'Users', 


# Django 默认 创建 的 应 用 程序 
--517]-- 
] 


-- Snip-- 


这 样 ，Django 将 把 应 用 程序 users 包含 到 项 目 中 。 


19.2.3 包含 users 的 URL 
接 下 来 ， 需 要 修改 项 目 根 目录 中 的 urls.py， 使 其 包含 将 为 应 用 程序 users 定义 的 URL: 


urls.py from django.contrib import admin 
from django.urls import path, include 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('users/', include('users.urls')), 
path('', include('learning logs.urls')), 
] 


我 们 添加 了 一 行 代 码 , 以 包含 应 用 程序 users 中 的 文件 urls.py。 这 行 代码 与 任何 以 单词 users 
打头 的 URL (如 http://localhost:8000/users/login/ ) 都 匹配 。 


19.2.4 登录 页 面 


首先 来 实现 登录 页 面 。 我 们 将 使 用 Django 提供 的 默认 视图 login， 因 此 这 个 应 用 程序 的 URL 


模式 稍 有 不 同 。 在 目录 learning_log/users/ 中 ， 新 建 一 个 名 为 urls.py 的 文件 ， 并 在 其 中 添加 如 下 
代码 : 


urls.py “""" 为 应 用 程序 Users 定义 URL 模式 。""" 
from django.urls import path, include 


@ app name = "users’ 
urlpatterns = [ 
# 包含 默认 的 身份 验证 URL。 
@ path('', include('django.contrib.auth.urls')), 
] 


导入 函数 path 和 include， 以 便 包含 Django 定义 的 一 些 默 认 的 身份 验证 URL。 这 些 默 认 的 
URL 包 含 具名 的 URL 模 式 , 如 '1login' 和 'logout' ,我 们 将 变量 app_name 设 置 成 'users' ,让 Django 
能 够 将 这 些 URL 与 其 他 应 用 程序 的 URL 区 分 开 来 ( 见 @ )。 即 便 是 Django 提供 的 默认 URL, 将 
其 包含 在 应 用 程序 users 的 文件 中 后 ， 也 可 通过 命名 空间 users 进行 访问 。 
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登录 页 面 的 URL 模式 与 URL http://localhost:8000/users/login/ 匹 配 ( 见 @ )。 这 个 URL 中 的 单词 
users i 上 Django 在 users/urls.py 中 查找 ， 而 单词 login 让 它 将 请 求 发 送 给 Django 的 默认 视图 login。 


1. 模板 login.html 

用 户 请 求 登录 页 面 时 ，Django 将 使 用 一 个 默认 的 视图 函数 ， 但 我 们 依然 需要 为 这 个 页 面 提 
供 模板 。 默认 的 身份 验证 视图 在 文件 夹 registration 中 查找 模板 ,因此 我 们 需要 创建 这 个 文件 夹 。 
为 此 ， 在 日 录 learning log/users/ 中 新 建 一 个 名 为 templates 的 目录 ， 再 在 这 个 目录 中 新 建 一 个 
名 为 registration 的 目录 。 下 面 是 模板 login.html， 应 将 其 存储 到 目录 learning log/users/templates/ 
registration 中 : 


login.him! {% extends "learning logs/base.html" %} 


{% block content %} 


@ {% if form.errors %} 
<p>Your username and password didn't match. Please try again.</p> 
{% endif %} 
@ <form method="post" action="{% url 'users:login' %}"> 
{% csrf token %} 
(3 {{ form.as p }} 
Q <button name="submit">Log in</button> 
9 <input type="hidden" name="next" 


value="{% url 'learning logs:index' %}" /> 
</form> 


{% endblock content %} 


这 个 模板 继承 了 base.html， 旨 在 确保 登录 页 面 的 外 观 与 网 站 的 其 他 页 面相 同 。 请 注意 , 一 个 
应 用 程序 中 的 模板 可 继承 另 一 个 应 用 程序 中 的 模板 。 

如 果 设 置 表单 的 errors 属性 ， 就 显示 一 条 错误 消息 ( 见 @ )， 指 出 输入 的 用 户 名 密码 对 与 数 
据 库 中 存储 的 任何 用 户 名 密码 对 都 不 匹配 。 

我 们 要 让 登录 视图 对 表单 进行 处 理 ， 因 此 将 实 参 action 设置 为 登录 页 面 的 URL ( 见 @ )。 
登录 视图 将 一 个 表单 发 送 给 模板 。 在 模板 中 ， 我 们 显示 这 个 表单 ( 见 @ ) 并 添加 一 个 提交 按钮 
( 见 @ ), 在 @ 处 , 包含 了 一 个 隐藏 的 表单 元 素 'next' ， 其 中 的 实 参 value 告诉 Django 在 用 户 成 功 
登录 后 将 其 重 定向 到 什么 地 方 。 在 本 例 中 ， 用 户 将 返回 主页 。 


2. 链接 到 登录 页 面 


下 面 在 base.html 中 添加 到 登录 页 面 的 链接 ， 让 所 有 页 面 都 包含 它 。 用 户 已 登录 时 ， 我 们 不 19 
想 显 示 这 个 链接 ， 因 此 将 它 租 套 在 一 个 {% if %} 标 签 中 : 
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base.htiml 《py> 
<a href="{% url 'learning logs:index' %}">Learning Log</a> - 
<a href="{% url 'learning logs:topics' %}">Topics</a> - 


@ {% if user.is authenticated %} 
© Hello, {{ user.username }}. 
{% else %} 
(34 <a href="{% url 'users:login' %}">Log in</a> 
{% endif %} 
</p> 


{% block content %}{% endblock content %} 


在 Django 身份 验证 系统 中 , 每 个 模板 都 可 使 用 变量 user。 这 个 变量 有 一 个 is_authenticated 
属性 : 如 果 用 户 已 登录 ， 该 属性 将 为 True， 否 则 为 False。 这 让 你 能 够 向 已 通过 身份 验证 的 用 户 
显示 一 条 消息 ， 而 向 未 通过 身份 验证 的 用 户 显 示 另 一 条 消息 。 

这 里 向 已 登录 的 用 户 显 示 问 候 语 ( 见 @ )。 对 于 已 通过 身份 验证 的 用 户 ， 还 设置 了 属性 
username。 这 里 使 用 该 属性 来 个 性 化 问候 语 ， 让 用 户 知道 自己 已 登录 ( 见 @ )。 在 @ 处 , 对 于 尚未 


通过 身份 验证 的 用 户 ， 显 示 到 登录 页 面 的 链接 。 

3. 使 用 登录 页 面 

前 面 建立 了 一 个 用 户 账户 , 下 面 来 登录 一 下 , 看 看 登录 页 面 是 否 管用 。 请 访问 http://localhost: 
8000/admin/， 如 果 你 依然 是 以 管理 员 身 份 登录 的 ， 请 在 页 眉 上 找到 注销 链接 并 单 击 它 。 

注销 后 ， 访 问 http://localhost:8000/users/login/ 将 看 到 类 似 于 图 19-4 所 示 的 登录 页 面 。 输 入 你 
在 前 面 设置 的 用 户 名 和 密码 , 将 进入 索引 页 面 。 在 这 个 主页 的 页 眉 中 , 显示 了 一 条 个 性 化 问候 语 ， 
其 中 包含 你 的 用 户 名 。 


@ @ < @ localhost:8000/users/login/ ef © 站 器 


Learning Log - Topics - Log in 
Username: 
Password: 


Log in 


图 19-4 登录 页 面 


19.2.5 ”注销 
现在 需要 提供 一 个 让 用 户 注 销 的 途径 。 为 此 ， 我 们 将 在 base.html 中 添加 一 个 注销 链接 。 用 
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户 单 击 这 个 链接 时 ,将 进入 一 个 确认 其 已 注销 的 页 面 。 
1. 在 base.html 中 添加 注销 链接 


下 面 在 base.html 中 添加 注销 链接 ， 让 每 个 页 面 都 包含 它 。 将 注销 链接 放 在 {% if user.is_ 
authenticated %} 部 分 中 ， 这 样 只 有 已 登录 的 用 户 才 能 看 到 它 : 


base.himl -- s/n1p-- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a href="{% url 'users:logout' %}">Log out</a> 
{% else %} 
-- Snip-- 


默认 的 具名 注销 URL 模式 为 'logout'。 
2. 注销 确认 页 面 
成 功 注销 后 , 用 户 和 希望 获悉 这 一 点 。 因 此 默认 的 注销 视图 使 用 模板 logged_out.html 泻 染 注销 


确认 页 面 ,我们 现在 就 来 创建 该 模板 。 下 面 这 个 简单 的 页 面 确认 用 户 已 注销 , 请 将 其 存储 到 目录 
templates/registration( login.html 所 在 的 目录 ) 中 : 


logged outhim! {% extends "learning logs/base.html" %} 


{% block content %} 
<p>You have been logged out. Thank you for visiting!</p> 
{% endblock content %} 


在 这 个 页 面 中 ， 不 需要 提供 其 他 内 容 ， 因 为 base.html 提供 了 到 主页 和 登录 页 面 的 链接 。 

19-5 显示 了 用 户 单 击 Log out 链接 后 出 现 的 注销 确认 页 面 。 这 里 的 重点 是 创建 能 够 正确 工 
作 的 网 站 ,因此 几乎 没有 设置 样式 。 确定 所 需 的 功能 都 能 正确 运行 后 , 我 们 将 设置 这 个 网 站 的 样 
式 , 使 其 看 起 来 更 专业 。 


@O@@e@ & 6 localhost:8000/users/logout/ © © 由 5] 


Learning Log - Topics - Log in 


You have been logged out. Thank you for visiting! 


图 19-5 ”注销 确认 页 面 指 出 用 户 已 成 功 注销 
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19.2.6 ”注册 页 面 


下 面 来 创建 一 个 页 面 供 新 用 户 注 册 。 我 们 将 使 用 Django 提供 的 表单 UserCreationForm, 但 
编写 自己 的 视图 函数 和 模板 。 


1. 注册 页 面 的 URL 模式 
下 面 的 代码 定义 了 注册 页 面 的 URL 模式 ， 它 也 包含 在 users/urls.py 中 : 


urls.jpy “"，" "为 应 用 程序 Users 定义 URL 模式 。""" 
from django.urls import path, include 
from . import views 


app_name = 'Users" 
urlpatterns = [ 
# 包含 默认 的 身份 验证 URL。 
path('', include('django.contrib.auth.urls')), 
# 注册 页 面 
path('register/', views.register, name='register'), 


] 


我 们 从 users 中 导入 模块 views。 为 何 需要 这 样 做 呢 ? 因为 我 们 将 为 注册 页 面 编 写 视 图 函数 。 
注册 页 面 的 URL 模式 与 URL http://localhost:8000/users/register/ 匹 配 , 并 将 请 求 发 送 给 即将 编写 的 
函数 register()。 


2. 视图 函数 register() 

在 注册 页 面 首次 被 请 求 时 , 视图 函数 register() 需 要 显示 一 个 空 的 注册 表单 ,并 在 用 户 提交 
填写 好 的 注册 表单 时 对 其 进行 处 理 。 如 果 注 册 成 功 ， 这 个 函数 还 需 让 用 户 自动 登录 。 请 在 
users/views.py 中 添加 如 下 代码 : 


views.py from django.shortcuts import render, redirect 
from django.contrib.auth import login 
from django.contrib.auth.forms import UserCreationForm 


def register(request): 
if request.method != 'POST': 
# 显示 空 的 注册 表单 。 


© form = UserCreationForm() 
else: 
# 处 理 填 写 好 的 表单 。 
(2 form = UserCreationForm(data=request.POST) 
(3 if form.is valid(): 
@ new user = form.save() 


# 让 用 户 自动 登录 ， 再 重 定向 到 主页 。 
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© login(request, new user) 
© return redirect('learning logs:index') 


# 显示 空 表单 或 指出 表单 无 效 。 
context = {'form': form} 


return render(request, 'registration/register.html', context) 


首先 导入 函数 render() 和 redirect()， 然 后 导入 孔 数 login()， 以 便 在 用 户 正确 填写 了 注册 
言 息 时 让 其 自动 登录 。 我 们 还 导入 了 默认 表单 UserCreationForm。 在 函数 register() 中 ,检查 要 
响应 的 是 否 是 POST 请 求 。 如 果 不 是 ， 就 创建 一 个 UserCreationForm 实例 ， 且 不 给 它 提供 任何 初 


始 数 据 ( 见 @ )。 


如 果 响 应 的 是 POST 请 求 ， 就 根据 提交 的 数据 创建 一 个 UserCreationForm 实例 ( 见 @ )， 并 
检查 这 些 数据 是 否 有 效 ( 见 @ )。 就 本 例 而 言 ， 有 效 是 指 用 户 名 未 包含 非法 字符 ， 输 入 的 两 个 密 


码 相 同 ， 以 及 用 户 没有 试图 做 恶意 的 事情 。 


如 果 提 交 的 数据 有 效 , 就 调用 表单 的 方法 save(), 将 用 户 名 和 密码 的 散 列 值 保存 到 数据 库 中 
( 见 @ )。 方法 save() 返 回 新 创建 的 用 户 对 象 , 我 们 将 它 赋 给 了 new_user。 保存 用 户 的 信息 后 ， 调 
用 函数 login() 并 传人 对 象 request 和 new_user， 为 用 户 创建 有 效 的 会 话 ， 从 而 让 其 自动 登录 


( 见 @ )。 最 后 ,将 用 户 重 定向 到 主页 ( 见 @ )， 而 主页 的 页 丑 


用 户 知道 注册 成 功 了 。 


中 


显示 了 一 条 个 性 化 的 问候 语 ， 让 


在 这 个 函数 的 末尾 , 我 们 泻 染 了 注册 页 面 : 它 要 么 显示 一 个 空 表单 , 要 么 显示 提交 的 无 效 表单 。 


3. 注册 模板 


下 面 来 创建 注册 页 面 的 模板 ， 它 与 登录 页 面 的 模板 类 似 。 请 务必 将 其 保存 到 login.html 所 在 


的 目录 中 : 


register.him! {% extends "learning logs/base.html" %} 
{% block content %} 


<form method="post" action="{% url 'users:register' %}"> 
{% csrf token %} 
{{ form.as p }} 


<button name="submit">Register</button> 


<input type="hidden" name="next" value="{% url 'learning logs:index' %}" /> 


</form> 


{% endblock content %} 


这 里 也 使 用 了 方法 as_p， 让 Django 在 表单 中 正确 地 显示 所 有 的 字段 ， 包 括 错 误 消息 一 一 如 


果 用 户 没有 正确 地 填写 表单 。 
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4. 链接 到 注册 页 面 
下 面 来 添加 一 些 代码 ， 在 用 户 没 有 登录 时 显示 到 注册 页 面 的 链接 : 


base.himl -- s/n1p-- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a href="{% url 'users:logout' %}">Log out</a> 
{% else %} 
<a href="{% url 'users:register' %}">Register</a> - 
<a href="{% url 'users:login' %}">Log in</ay> 
{% endif %} 
-- Snip-- 


现在 , 已 登录 的 用 户 看 到 的 是 个 性 化 的 问候 语 和 注销 链接 ， 而 未 登录 的 用 户 看 到 的 是 注册 链 
接 和 登录 链接 。 请 尝试 使 用 注册 页 面 创建 几 个 用 户 名 各 不 相同 的 用 户 账户 。 


下 一 节 会 将 一 些 页 面 限制 为 仅 让 已 登录 的 用 户 访问 ， 还 将 确保 每 个 主题 都 归属 于 特定 用 户 。 


注意 这 里 的 注册 系统 允许 用 户 创建 任意 数量 的 账户 。 有 些 系统 要 求 用 户 确 认 其 身份 : 发 送 一 
封 确认 邮件 ， 用 户 回复 后 账户 才 生 效 。 通 过 这 样 做 ， 这 些 系统 会 比 本 例 的 简单 系统 生成 
更 少 的 垃圾 账户 。 然 而 ， 学 习 创建 应 用 程序 时 ， 完 全 可 以 像 这 里 所 做 的 那样 ， 使 用 简单 
的 用 户 注册 系统 。 


动手 试 一 斌 


练习 19-2: 博客 账户 在 为 完成 练习 19-1 而 开发 的 项 目 Blog 中 ， 添 加 用 户 身份 验 
证 和 注册 系统 。 向 已 登录 的 用 户 显示 其 用 户 名 ,向 未 注册 的 用 户 显示 到 注册 页 面 的 链接 。 


19.3 ”让 用 户 拥有 自己 的 数据 
用 户 应 该 能 够 输入 其 专 有 的 数据 ， 因 此 我 们 将 创建 一 个 系统 ,确定 各 项 数据 所 属 的 用 户 , 再 
限制 对 页 面 的 访问 ， 让 用 户 只 能 使 用 自己 的 数据 。 


本 节 将 修改 模型 Topic， 让 每 个 主题 都 归属 于 特定 用 户 。 这 也 将 影响 条 目 ， 因 为 每 个 条 目 都 
属于 特定 的 主题 。 我 们 先 来 限制 对 一 些 页 面 的 访问 。 


19.3.1 ”使 用 @login required 限制 访问 


Django 提供 了 装饰 器 @login_ required， 让 你 能 够 轻松 地 只 允许 已 登录 用 户 访问 某 些 页 面 。 
装饰 器 ( decorator ) 是 放 在 函数 定义 前 面 的 指令 ，Python 在 函数 运行 前 根据 它 来 修改 函数 代码 的 
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行为 。 下 面 来 看 一 个 示例 。 
1. 限制 访问 显示 所 有 主题 的 页 面 


每 个 主题 都 归 特 定 用 户 所 有 ， 因 此 应 只 允许 已 登录 的 用 户 请 求 显 示 所 有 主题 的 页 面 。 为 此 ， 
在 learning logs/views.py 中 添加 如 下 代码 : 


views.py from django.shortcuts import render, redirect 
from django.contrib.auth.decorators import login required 


from .models import Topic, Entry 
-- Ship-- 


@login required 

def topics(request): 
""" 显 示 所 有 的 主题 。”""" 
-- Snip-- 


首先 导入 函数 login_required() 。 将 login required() 作 为 装饰 器 应 用 于 视图 函数 
topics() 在 它 前 面 加 上 符号 @ 和 login_required， 让 Python 在 运行 topics() 的 代码 之 前 运行 
login_ required() 的 代码 。 

login_required() 的 代码 检查 用 户 是 否 已 登录 ， 仪 当 用 户 已 登录 时 ，Django 才 运 行 topics() 
的 代码 。 如 果 用 户 未 登录 ， 就 重 定向 到 登录 页 面 。 

为 实现 这 种 重 定向 ， 需 要 修改 settings.py， 让 Django 知道 到 哪里 去 查找 登录 页 面 。 请 在 
settings.py 末尾 添加 如 下 代码 : 


settings.py  -- 5/11p-- 


# 我 的 设置 
LOGIN URL = ‘users:1login’ 


现在 ， 如果 未 登录 的 用 户 请 求 装饰 侨 @login required 保护 的 页 面 ，Django 将 重 定向 到 settings.py 
中 的 LOGIN_URL 指定 的 URL。 


要 测试 这 个 设置 ， 可 注销 并 进入 主页 ， 再 单 击 链接 Topics， 这 将 重 定向 到 登录 页 面 。 然 后 ， 
使 用 你 的 账户 登录 ， 并 再 次 单 击 主页 中 的 Topics 链接 ， 你 将 看 到 显示 所 有 主题 的 页 面 。 
2. 全 面 限制 对 项 目 “ 学 习 笔 记 ” 的 访问 


Django 让 你 能 够 轻松 地 限制 对 页 面 的 访问 , 但 你 必须 确定 要 保护 哪些 页 面 。 最 好 先 确 定 项 目 
的 哪些 页 面 不 需要 保护 ， 再 限制 对 其 他 所 有 页 面 的 访问 。 你 可 轻松 地 修改 过 于 严格 的 访问 限制 。 
比 起 不 限制 对 敏感 页 面 的 访问 ， 这 样 做 的 风险 更 低 。 


在 项 目 “ 学 习 笔记 ”中 , 将 不 限制 对 主页 和 注册 页 面 的 访问 , 并 限制 对 其 他 所 有 页 面 的 访问 。 
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在 下 面 的 learning logs/viewspy 中 ， 对 除 index() 外 的 每 个 视图 都 应 用 了 装饰 器 @Qlogin_ required: 


views.py --5/1p-- 

@login required 

def topics(request): 
-- Snip-- 


@login required 
def topic(request, topic id): 
-- Snip-- 


@login required 
def new topic(request): 
-- Ship-- 


@login required 
def new entry(request, topic id): 
-- SNip-- 


@login required 
def edit entry(request, entry id): 
-- Snip-- 


如 果 你 在 未 登录 的 情况 下 尝试 访问 这 些 页 面 , 将 被 重 定 问 到 登录 页 面 。 另 外， 你 还 不 能 单 击 
到 new topic 等 页 面 的 链接 。 如 果 你 输入 URL http:/localhost:8000mew topic/， 将 被 重 定向 到 登 
录 页 面 。 对 于 所 有 与 私有 用 户 数 据 相 关 的 URL， 都 应 限制 访问 。 


19.3.2 ”将 数据 关联 到 用 户 

现在 , 需要 将 数据 关联 到 提交 它们 的 用 户 。 只 需 将 最 高 层 的 数据 关联 到 用 户 ， 更 低层 的 数 
据 就 会 自动 关联 到 用 户 。 例 如 ， 在 项 目 “ 学 习 笔 记 ” 中 ， 应 用 程序 的 最 高 层 数 据 是 主题 ， 而 所 
有 条 目 都 与 特定 主题 相关 联 。 只 要 每 个 主题 都 归属 于 特定 用 户 ， 就 能 确定 数据 库 中 每 个 条 目的 
所 有 者 。 

下 面 来 修改 模型 Topic， 在 其 中 添加 一 个 关联 到 用 户 的 外 键 。 这 样 做 之 后 ， 必 须 对 数据 库 进 
行 迁移 。 最 后 ， 必 须 修 改 某 些 视图 ， 使 其 只 显示 与 当前 登录 的 用 户 相关 联 的 数据 。 

1. 修改 模型 Topic 

对 models.py 的 修改 只 涉及 两 行 代码 : 


models.py from django.db import models 
from django.contrib.auth.models import User 


class Topic(models.Model): 
"" "用户 学 习 的 主题 。""" 
text = models.CharField(max length=200) 
date added = models.DateTimeField(auto now add=True) 
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owner = models.ForeignKey(User, on delete=models .CASCADE) 


def str (self): 
"" "返回 模型 的 字符 囊 表 示 。""" 
return self.text 


class Entry(models.Model) 
-- SNip-- 


首先 导入 django.contrib.auth 中 的 模型 User, 然后 在 Topic 中 添加 字段 owner, 它 建立 到 模 
型 User 的 外 键 关系 。 用 户 被 删除 时 ， 所 有 与 之 相关 联 的 主题 也 会 被 删除 。 


2. 确定 当前 有 了 哪些 用 户 


迁移 数据 库 时 , Django 将 对 数据 库 进行 修改 , 使 其 能 够 存储 主题 和 用 户 之 间 的 关联 。 为 执行 
迁移 , Django 需要 知道 该 将 各 个 既 有 主题 关联 到 哪个 用 户 。 最 简单 的 办 法 是 , 将 既 有 主题 都 关联 
到 同一 个 用 户 ， 如 超级 用 户 。 为 此 ， 需 要 知道 该 用 户 的 人 D。 


下 面 来 查看 已 创建 的 所 有 用 户 的 ID。 为 此 ， 启 动 一 个 Django shell 会 话 ， 并 执行 如 下 命令 : 


(1] env)learning log$ python manage.py shell 

@ >>> from django.contrib.auth.models import User 
@ >>> User.objects.all() 

<QuerySet [<User: 1] admin>, <User: eric>, <User: willie>]> 
@ >>> for user in User.objects.all(): 

print(user.username, user.id) 

1] admin 1 

eric 2 

willie 3 

>>> 


在 @ 处 ， 在 shell 会 话 中 导入 模型 User。 然 后 ， 查 看 到 目前 为 止 都 创建 了 哪些 用 户 ( 见 @ )。 
输出 中 列 出 了 三 个 用 户 : 11 admin、eric 和 willie。 


在 @ 处 ,遍历 用 户 列 表 并 打印 每 位 用 户 的 用 户 名 和 ID。Django 询问 要 将 既 有 主题 关联 到 哪 
个 用 户 时 ， 我 们 将 指定 其 中 一 个 了 值 。 


3. 迁移 数据 库 


知道 用 户 ID 后 ， 就 可 迁移 数据 库 了 。 这 样 做 时 ，Python 将 询问 你 是 要 和 暂时 将 模型 Topic 关 
联 到 特定 用 户 ， 还 是 在 文件 models.py 中 指定 默认 用 户 。 请 选择 第 一 个 选项 。 


@ (11_env)learning_ log$ python manage.py makemigrations learning logs 

@ You are trying to add a non-nullable field ‘owner' to topic without a default; 
we can't do that (the database needs something to populate existing rows). 

四 Please select a fix: 


1) Provide a one-off default now (will be set on all existing rows with a 
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null value for this column) 
2) Quit, and let me add a default in models.py 
@ Select an option: 1 
©@ Please enter the default value now, as valid Python 
The datetime and django.utils.timezone modules are available, so you can do 
e.g. timezone.now 
Type 'exit' to exit this prompt 
© >>>1 
Migrations for 'learning logs': 
learning logs/migrations/0003 topic owner.py 
- Add field owner to topic 
(1] env)learning log$ 


首先 执行 命令 makemigrations( 见 @ ), 在 @ 处 的 输出 中 , Django 指出 你 试图 给 既 有 模型 Topic 
添加 一 个 必 不 可 少 (不 可 为 空 ) 的 字段 , 而 该 字段 没有 默认 值 。 在 人 @ 处 , Django 提供 了 两 种 选择 : 
要 么 现在 提供 默认 值 , 要 么 退出 并 在 models.py 中 添加 默认 值 。 在 @ 处 ,我 们 选择 了 第 一 个 选项 ， 
此 Django 让 我 们 输入 默认 值 ( 见 @ )。 


为 将 所 有 既 有 主题 都 关联 到 管理 用 户 1 admin， 我 们 输入 用 户 站 值 1( 见 @8 )。 可 以 使 用 已 
创建 的 任何 用 户 的 ID ， 而 非 必 须 是 超级 用 户 。 接 下 来 ，Django 使 用 这 个 值 来 迁移 数据 库 ， 并 生 
成 了 迁移 文件 0003 topic_ ownerpy， 它 在 模型 Topic 中 添加 字段 owner。 


现在 可 以 执行 迁移 了 。 为 此 ， 在 活动 状态 的 虚拟 环境 中 执行 如 下 命令 : 


(11_env)learning log$ python manage.py migrate 
Operations to perform: 
Apply all migrations: admin, auth, contenttypes, learning logs, sessions 
Running migrations: 
@ Applying learning logs.0003 topic owner... OK 
(1] env)learning log$ 


Django 应 用 新 的 迁移 ， 结 果 一 切 顺 利 ( 见 @ )。 
为 验证 迁移 符合 预期 ， 可 在 shell 会 话 中 像 下 面 这 样 做 : 


@ >>> from learning logs.models import Topic 
@ >>> for topic in Topic.objects.all(): 
print(topic, topic.owner) 


Chess 1] admin 


Rock Climbing 11 admin 
>>> 


我 们 从 learning logs.models 中 导入 Topic ( 见 @ )， 再 遍历 所 有 的 既 有 主题 ， 并 打印 每 个 主 
题 及 其 所 属 的 用 户 ( 见 @ )。 如 你 所 见 ， 现 在 每 个 主题 都 属于 用 户 1L_admin。 如 果 你 在 运行 这 些 
代码 时 出 错 ， 请 尝试 退出 并 重启 shell。 
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注意 ”你 可 以 重 置 数据 库 而 不 是 迁移 它 ， 但 如 果 这 样 做 ， 既 有 的 数据 都 将 丢失 。 一 种 不 错 的 做 
法 是 ， 学 习 如 何在 迁移 数据 库 的 同时 确保 用 户 数 据 的 完整 性 。 如 果 你 确实 想 要 一 个 全 新 
的 数据 库 ， 可 执行 命令 python manage.py flush， 这 将 重建 数据 库 的 结构 。 如 果 这 样 做 ， 
就 必须 重新 创建 超级 用 户 ， 且 原来 的 所 有 数据 都 将 丢失 。 


19.3.3 ”只 允许 用 户 访问 自己 的 主题 


当前 , 不 管 以 哪个 用 户 的 身份 登录 ， 都 能 够 看 到 所 有 的 主题 。 下 面 改变 这 一 点 ， 只 向 用 户 显 
示 属 于 其 自己 的 主题 。 


在 views.py 中 ， 对 函数 topics() 做 如 下 修改 : 


views.py --5/1p-- 

@login required 

def topics(request): 
"" "显示 所 有 的 主题 。""" 
topics = Topic.objects.filter(owner=request.user).order by('date added') 
context = {'topics': topics} 
return render(request, 'learning logs/topics.html', context) 

-- Snip-- 


用 户 登 录 后 ，request 对 象 将 有 一 个 user 属性 ， 其 中 存储 了 有 关 该 用 户 的 信息 。 查 询 
Topic.objects.filter(owner=request.user) 让 Django 只 从 数据 库 中 获取 owner 属性 为 当前 用 户 
的 Topic 对 象 。 由 于 没有 修改 主题 的 显示 方式 ， 无 须 对 显示 所 有 主题 的 页 面 的 模板 做 任何 修改 。 


要 查看 结果 ,以 所 有 既 有 主题 关联 到 的 用 户 的 身份 登录 ,并 访问 显示 所 有 主题 的 页 面 , 你 将 
看 到 所 有 的 主题 。 然 后 ， 注 销 并 以 男 一 个 用 户 的 身份 登录 ， 该 页 面 将 不 列 出 任何 主题 。 


19.3.4 ”保护 用 户 的 主题 
我 们 还 没有 限制 对 显示 单个 主题 的 页 面 的 访问 ， 因 此 任何 已 登录 的 用 户 都 可 输入 类 似 于 
http://localhost:8000/topics/1/ 的 URL， 来 访问 显示 相应 主题 的 页 面 。 


你 自己 试 一 试 就 明白 了 。 以 拥有 所 有 主题 的 用 户 的 身份 登录 , 访问 特定 的 主题 , 并 复制 该 页 
面 的 URL 或 将 其 中 的 D 记录 下 来 。 然后 ,注销 并 以 男 一 个 用 户 的 身份 登录 , 再 输入 显示 前 述 主 
题 的 页 面 的 URL。 虽 然 你 是 作为 男 一 个 用 户 登录 的 ,但 依然 能 够 查看 该 主题 中 的 条 目 。 


为 修复 这 种 问题 ， 我 们 在 视图 函数 topic() 获 取 请 求 的 条 目前 执行 检查 : 


views.py from django.shortcuts import render, redirect 
from django.contrib.auth.decorators import login required 
@ from django.http import Http404 


--SNip-- 
@login required 


394 第 19 章 用 户 账 户 


def topic(request, topic id): 
""" 显 示 单 个 主题 及 其 所 有 的 条 目 。""" 
topic = Topic.objects.get(id=topic id) 
# 确认 请 求 的 主题 属于 当前 用 户 。 
2 if topic.owner != request.user: 
raise Http404 


entries = topic.entry set.order by('-date added') 

context = {'topic': topic, ‘entries': entries} 

return render(request, 'learning logs/topic.html', context) 
=- SNhIp-- 


服务 器 上 没有 请 求 的 资源 时 , 标准 的 做 法 是 返回 404 响应 , 这 里 导入 了 异常 Http404( 见 @ )， 
并 在 用 户 请 求 其 不 应 查看 的 主题 时 引发 这 个 异常 。 收 到 主题 请 求 后 , 在 演 染 页 面前 检查 该 主题 是 
否 属于 当前 登录 的 用 户 。 如 果 请 求 的 主题 不 归 当 前 用 户 所 有 ， 就 引发 Http404 异常 ( 见 @ )， 让 
Dijango 返回 一 个 404 错误 页 面 。 


现在 ， 如果 你 试图 查看 其 他 用 户 的 主题 条 目 , 将 看 到 Django 发 送 的 消息 PageNot Found。 第 
20 章 将 对 这 个 项 目 进行 配置 ， 让 用 户 看 到 更 合适 的 错误 页 面 。 


19.3.5 ”保护 页 面 edit_entry 


页 面 edit_entry 的 URL 形式 为 http://localhost:8000/edit entry/entry i4/， 其 中 enty id 
是 一 个 数 。 下 面 来 保护 这 种 页 面 , 禁止 用 户 通过 输入 类 似 于 前 面 的 URL 来 访问 其 他 用 户 的 条 目 : 


views.py --5/1p-- 

@login required 

def edit entry(request, entry id): 
"" "编辑 既 有 条 目 
entry = Entry.objects.get(id=entry id) 
topic = entry.topic 
if topic.owner != request.user: 

raise Http404 


if request.method != 'POST': 
-- Snip-- 


我 们 首先 获取 指定 的 条 目 以 及 与 之 相关 联 的 主题 , 再 检查 主题 的 所 有 者 是 否 是 当前 登录 的 用 
户 。 如 果 不 是 ， 就 引发 Http404 异常 。 


19.3.6 ”将 新 主题 关联 到 当前 用 户 


当前 , 用 于 添加 新 主题 的 页 面 存在 问题 一 一 没有 将 新 主题 关联 到 特定 用 户 。 如 果 你 尝试 添加 
新 主题 ,将 看 到 错误 消息 IntegrityError， 指 出 learning_logs_topic.user id 不 能 为 NULL (NOT 
NULL constraint failed: learning logs topic.owner id )。Django 的 意思 是 说 ,创建 新 主题 时 ， 
必须 给 owner 字段 指定 值 。 
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我 们 可 通过 request 对 象 获 悉 当 前 用 户 ， 因 此 有 一 个 修复 该 问题 的 简单 方案 。 请 添加 下 面 的 
代码 ， 将 新 主题 关联 到 当前 用 户 : 


views.py --5/1p-- 
@login required 
def new topic(request): 
"" "添加 新 主题 
if request.method != “POST : 
# 没有 提交 的 数据 : 创建 一 个 空 表单 
form = TopicForm() 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
form = TopicForm(data=request.POST) 
if form.is valid(): 
new topic = form.save(commit=False) 
new topic.owner = request.user 
new topic.save() 
return redirect('learning logs:topics') 


@Q@Oe 


# 显示 一 个 空 表单 或 指出 表单 无 效 

context = {'form': form} 

return render(request, 'learning logs/new topic.html', context) 
-- SNip-- 


首先 调用 form.save() 并 传递 实 参 commit=False ( 见 @ )， 因 为 要 先 修改 新 主题 ,再 将 其 保存 
到 数据 库 。 接 下 来 ， 将 新 主题 的 owner 属性 设置 为 当前 用 户 ( 见 @ )。 最 后 ， 对 刚 定义 的 主题 实 
例 调用 save() ( 见 @ )。 现在， 主题 包含 所 有 必 不 可 少 的 数据 ， 将 被 成 功 保存 。 


这 个 项 目 现在 允许 任何 用 户 注册 , 而 每 个 用 户 想 添加 多 少 新 主题 都 可 以 。 每 个 用 户 都 只 能 访 
问 自己 的 数据 ， 无 论 是 查看 数据 、 输 入 新 数据 还 是 修改 旧 数 据 时 都 如 此 。 


动手 试 一 斌 


练习 19-3: 重 构 在 views.py 中 ， 我 们 在 两 个 地 方 核实 了 主题 关联 到 的 用 户 为 当 
前 登录 的 用 户 。 请 将 执行 这 种 检查 的 代码 放 在 函数 check topic owner() 中 ， 并 在 这 两 
个 地 方 调用 该 函数 。 

练习 19-4: 保护 页 面 new_entry 一 个 用 户 可 在 另 一 个 用 户 的 学 习 笔 记 中 添加 人 条目， 


方法 是 在 URL 中 指定 属于 另 一 个 用 户 的 主题 的 ID。 为 防范 这 种 攻击 ， 请 在 保存 新 条 目 
之 前 ， 核 实 它 所 属 的 主题 归属 于 当前 用 户 。 

练习 19-5: 受 保护 的 博客 在 你 创建 的 项 目 Blog 中 ,确保 每 篇 博文 都 与 特定 用 户 
相关 联 。 确 保 任何 用 户 都 可 访问 所 有 的 博文 ， 但 只 有 已 登录 的 用 户 能 够 发 表 博 文 和 编 
辑 既 有 博文 。 在 让 用 户 编辑 博文 的 视图 中 ， 在 处 理 表单 前 确认 用 户 编辑 的 是 其 自己 发 
表 的 博文 。 
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19.4 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 表单 来 让 用 户 添加 新 主题 、 添 加 新 条 目 以 及 编辑 既 有 条 目 ; 
如 何 实现 用 户 账户 ， 让 老 用 户 能 够 登录 和 注销 ， 并 且 使 用 Django 提供 的 表单 UserCreationForm 
让 用 户 创建 新 账户 。 


建立 简单 的 用 户 身 份 验证 和 注册 系统 后 ， 你 使 用 装饰 顺 @login_required 禁止 未 登录 的 用 户 
访问 特定 页 面 。 然 后 ， 你 通过 使 用 外 键 将 数据 关联 到 特定 用 户 ， 还 迁移 了 要 求 指定 默认 数据 的 数 
据 库 。 

最 后 ,你 学 习 了 如 何 修改 视图 函数 , 让 用 户 只 能 看 到 属于 自己 的 数据 。 你 使 用 方法 filter() 
来 获取 合适 的 数据 ， 并 学 习 了 如 何 将 被 请 求 数据 的 所 有 者 同 当前 登录 的 用 户 进 行 比较 。 

该 让 哪些 数据 可 随便 访问 ,又 该 对 哪些 数据 进行 保护 呢 ? 这 可 能 并 非 总 是 那么 显而易见 , 但 
通过 不 断 地 练习 就 能 掌握 这 种 技能 。 我 们 在 本 章 中 就 该 如 何 保护 用 户 数据 所 做 的 决策 表明 , 与 人 
合作 开发 项 目 是 个 不 错 的 主意 : 在 有 人 对 项 目 进行 检查 的 情况 下 ， 更 容易 发 现 其 注 弱 环节 。 

至 此 , 我 们 创建 了 一 个 功能 齐备 的 项 目 , 它 运行 在 本 地 计算 机 上 。 在 本 书 的 最 后 一 章 , 我 们 
将 设置 这 个 项 目的 样式 ,使 其 更 漂亮 ,还 将 把 它 部 署 到 一 台 服 务 器 上 , 让 任何 人 都 可 通过 互联 网 
注册 并 创建 账户 。 


设置 应 用 程序 的 样式 并 部 署 


当前 ,， 项目“ 学 习 笔记 ”虽然 功能 齐备 ， 但 未 设置 样式 ,也 只 
在 本 地 计算 机 上 运行 。 在 本 章 中 , 我 们 将 以 简单 而 专业 的 方式 设置 这 
个 项 目的 样式 ,再 将 其 部 署 到 一 台 服 务 器 上 , 让 世界 上 的 任何 人 都 
够 建立 账户 。 


会 已 
月 已 


为 设置 样式 ， 我 们 将 使 用 Bootstrap 库 ， 这 是 一 组 工具 ， 用 于 为 Web 应 用 程序 设置 样式 ， 使 
其 在 任何 现代 设备 上 都 看 起 来 很 专业 , 无 论 是 大 型 的 平板 显示 器 还 是 智能 手机 。 为 此 , 我 们 将 使 
用 应 用 程序 django-bootstrap4, 这 也 让 你 能 够 练习 使 用 其 他 Django 开发 人 员 开 发 的 应 用 程序 。 

我 们 将 把 项 目 “ 学 习 笔记 ”部 署 到 Heroku， 这 个 网 站 让 你 能 够 将 项 目 推送 到 其 服务 器 ， 让 
任何 有 互联 网 连接 的 人 都 可 以 使 用 它 。 我 们 还 将 使 用 版 本 控制 系统 Git 来 跟踪 对 这 个 项 目 所 做 的 
修改 。 

完成 项 目 “ 学 习 笔 记 ” 后 ， 你 将 能 够 开发 简单 的 Web 应 用 程序 ， 让 它们 看 起 来 很 漂亮 ， 再 
将 其 部 署 到 服务 器 。 你 还 能 够 利用 更 高 级 的 学 习 资 源 来 提高 技能 。 


20.1 设置 项 目 “ 学 习 笔记 ”的 样式 


之 前 , 我 们 特意 一 直 专 注 于 项 目 “ 学 习 笔记 ”的 功能 , 没有 考虑 样式 设置 问题 。 这 是 一 种 不 
错 的 开发 方法 ， 因 为 能 正确 运行 的 应 用 程序 才 是 有 用 的 。 当 然 ， 应 用 程序 能 够 正确 运行 后 ,外观 
就 显得 很 重要 了 ， 因 为 漂亮 的 应 用 程序 才能 吸引 用 户 。 


本 节 简 要 介绍 应 用 程序 django-bootstrap4, 并 演示 如 何 将 其 集成 到 项 目 中 , 为 部 署 做 好 准备 。 
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20.1.1 应 用 程序 django-bootstrap4 

我 们 将 使 用 django-bootstrap4 将 Bootstrap 集成 到 项 目 中 。 这 个 应 用 程序 下 载 必要 的 Bootstrap 
文件 ， 将 其 放 到 项 目的 合适 位 置 ， 让 你 能 够 在 项 目的 模板 中 使 用 样式 设置 指令 。 

为 安装 django-bootstrap4， 在 活动 状态 的 虚拟 环境 中 执行 如 下 命令 : 


(1] env)learning log$ pip install django-bootstrap4 


-- Snip-- 
Successfully installed django-bootstrap4-0.0.7 


接 下 来 , 需要 在 settings.py 的 INSTALLED_APPS 中 添加 如 下 代码 , 在 项 目 中 包含 应 用 程序 django- 
bootstrap4 : 
settings.py -- 5s/1p-- 


INSTALLED APPS = [ 
# 我 的 应 用 程序 
'learning logs', 
'Users', 
# 第 三 方 应 用 程序 
‘bootstrap4', 


# Django 默认 添加 的 应 用 程序 
'django.contrib.admin', 
== Snip-- 


新 建 一 个 名 为 “第 三 方 应 用 程序 ”的 片段 ， 用 于 指定 其 他 开发 人 员 开 发 的 应 用 程序 ， 并 在 其 
中 添加 'bootstrap4'。 务 必 将 这 个 片段 放 在 “我 的 应 用 程序 ”和 “Django 默认 添加 的 应 用 程序 ” 


之 间 。 


20.1.2 ”使 用 Bootstrap 设置 项 目 “ 学 习 笔记 ”的 样式 
Bootstrap 是 一 个 大 型 样式 设置 工具 集 , 还 提供 了 大 量 模板 , 可 应 用 于 项 目 以 创建 独特 的 总 体 
风格 。 对 Bootstrap 初学 者 来 说 ， 这 些 模板 比 样式 设置 工具 用 起 来 容易 得 多 。 要 查看 Bootstrap 提 
供 的 模板 ， 可 访问 其 官方 网 站 ， 单 击 Examples 并 找到 Navbars。 我 们 将 使 用 模板 Navbars static ， 
它 提供 了 简单 的 顶部 导航 栏 以 及 用 于 放置 页 面 内 容 的 容器 。 
20-1 显示 了 对 base.html 应 用 这 个 Bootstrap 模板 并 对 index.html 做 细微 修改 后 的 主页 。 
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生息 全 . 田 © locahosteo00 © ono 属 


Learning Log Topics Register Login 


Track your learning. 


Make your own Learning Log, and keep a list of the topics you're learning about. Whenever you learn 
something new about a topic, make an entry summarizing what you've learned. 


图 20-1 项 目 “ 学 习 笔记 ”的 主页 一 一 使 用 Bootstrap 设置 样式 后 


20.1.3 ”修改 base.html 
我 们 需要 修改 模板 base.html, 以 使 用 前 述 Bootstrap 模板 。 下 面 分 几 部 分 介绍 新 的 base.html。 
1. 定义 HTML 头 部 
对 base.html 所 做 的 第 一 项 修改 是 ， 在 其 中 定义 HTML 头 部 ， 使 得 显示 “学 习 笔记 ”的 每 个 


页 面 时 ， 浏 览 器 标题 栏 都 显示 该 网 站 名 。 此 外 ， 还 要 添加 一 些 在 模板 中 使 用 Bootstrap 所 需 的 信 
息 。 请 删除 base.html 的 全 部 代码 ， 并 输入 下 面 的 代码 : 


base.him! ©@ {% load bootstrap4 %} 


@ <!ldoctype html> 
四 <html lang="en"> 
@ chead> 
<meta charset="utf-8"> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
shrink-to-fit=no"> 
© <title>Learning Log</title> 


© {% bootstrap css %} 
{% bootstrap javascript jquery="'full' %} 


@ «</head> 


在 @ 人 处， 加 载 django-bootstrap4 中 的 模板 标签 集 。 接 下 来 ， 将 这 个 文件 声明 为 使 用 英语 ( 见 @ ) 
写 的 HTML 文 档 ( 见 @ )。HTML 文件 分 为 两 个 主要 部 分 : 头 部 (head ) 和 主体 (body )。 在 这 


汶 
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个 文件 中 , 头 部 始 于 @ 处 。HTML 文件 的 头 部 不 包含 任何 内 容 ， 只 是 向 浏览 器 提供 正确 显示 页 面 
所 需 的 信息 。@ 人 处 包含 一 个 title 元 素 ， 在 浏览 器 中 打开 网 站 “学 习 笔记 ”的 页 面 时 ， 浏览 器 的 
标题 栏 将 显示 该 元 素 的 内 容 。 

在 @ 处 ， 使 用 django-bootstrap4 的 一 个 自 定 义 模 板 标 签 ， 让 Django 包含 所 有 的 Bootstrap 样 


式 文件 。 接 下 来 的 标签 启用 你 可 能 在 页 面 中 使 用 的 所 有 交互 式 行为 ， 如 可 折 和 县 的 导航 栏 。@ 处 为 
结束 标签 <c/head> 。 


2. 定义 导航 栏 

定义 页 面 项 部 导航 栏 的 代码 很 长 , 因为 需要 同时 支持 较 罕 的 手机 屏幕 和 较 宽 的 台式 计算 机 显 
示 器 。 我 们 将 分 三 部 分 定义 导航 栏 。 

下 面 是 导航 栏 定义 代码 的 第 一 部 分 : 


base.himl --S]17OD-- 
</head> 
@ body> 


@ “nav class="navbar navbar-expand-md navbar-light bg-light mb-4 border"> 


@ <a class="navbar-brand" href="{% url 'learning logs:index'%}"> 
Learning Log</a> 


M49 <button class="navbar-toggler" type="button" data-toggle="collapse" 
data-target="#navbarCollapse" aria-controls="navbarCollapse" 
aria-expanded="false" aria-label="Toggle navigation"> 

<span class="navbar-toggler-icon"></span></button> 


第 一 个 元 素 为 起 始 标签 cbody> ( 见 @ )。HTML 文件 的 主体 包含 用 户 将 在 页 面 上 看 到 的 内 容 。 
@ 处 是 一 个 cnav> 元 素 ， 表 示 页 面 的 导航 链接 部 分 。 对 于 这 个 元 素 内 的 所 有 内 容 ， 都 将 根据 此 处 
的 navbar 和 navbar-expand-md 等 选择 器 定义 的 Bootstrap 样式 规则 来 设置 样式 ,选择 器 ( selector ) 
决定 了 样式 规则 将 应 用 于 页 面 上 的 哪些 元 素 。 选 择 器 navbar-light 和 bg-light 使 用 一 种 浅 色 主 
题 来 设置 导航 栏 的 颜色 。mb-4 中 的 mb 表示 下 边 距 ( margin-bottom )， 这 个 选择 器 确保 导航 栏 和 页 
面 其 他 部 分 之 间 有 一 些 空白 区 域 。 选 择 需 border 在 浅 色 背景 周围 添加 很 细 的 边框 ， 将 导航 栏 与 
页 面 其 他 部 分 分 开 。 


在 人 @ 处 ,指定 在 导航 栏 最 左 端 显 示 项 目 名 ,并 将 其 设置 为 到 主页 的 链接 ， 因 为 它 将 出 现在 
个 项 目的 每 个 页 面 中 。 选 择 器 navbar-brand 设置 这 个 链接 的 样式 ,使 其 比 其 他 链接 更 显眼 ， 
是 一 种 网 站 推广 方式 。 

@ 处 定义 了 一 个 按钮 ， 它 将 在 浏览 需 窗 口 太 窗 、 无 法 水 平 显 示 整 个 导航 栏 时 显示 出 来 。 如 果 
用 户 单 击 这 个 按钮 ,将 出 现 一 个 下 拉 列 表 ， 其 中 包含 所 有 的 导航 元 素 。 在 用 户 缩小 浏览 器 窗口 或 
在 屏幕 较 小 的 移动 设备 上 显示 网 站 时 ，collapse 会 导致 导航 栏 折 肥 起 来 。 


这 
这 


= 
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下 面 是 导航 栏 定义 代码 的 第 二 部 分 : 


base.himl -- Snip-- 
<Span class="navbar-toggler-icon"></span></button> 
@ <div class="collapse navbar-collapse” id="navbarCollapse"> 
@ <ul class="navbar-nav mr-auto"> 
@ <li class="nav-item"> 
<a class="nav-link" href="{% url 'learning logs:topics'%}"> 
Topics</a></1i> 
</ul> 


@ 处 开启 了 导航 栏 的 一 个 新 区 域 。div 是 division ( 分 隔 ) 的 缩写 。 我 们 创建 页 面 时 ,将 其 分 
隔 成 多 个 区 域 ， 并 指定 要 应 用 于 各 个 区 域 的 样式 和 行为 规则 。 在 <div> 起 始 标签 中 定义 的 样式 和 
行为 规则 将 影响 下 一 个 结束 标签 c/div> 之 前 的 所 有 元 素 。 这 里 指定 了 屏幕 或 窗口 太 窄 时 将 折 肥 起 
来 的 导航 栏 部 分 的 起 始 位 置 。 


@ 处 定义 了 一 组 链接 。Bootstrap 将 导航 元 素 定义 为 无 序列 表 项 , 但 使 用 的 样式 规则 让 它们 一 
点 也 不 像 列表 。 导 航 栏 中 的 每 个 链接 或 元 素 都 能 以 列表 项 的 方式 定义 。 这 里 只 有 一 个 列表 项 一 一 
到 显示 所 有 主题 的 页 面 的 链接 ( 见 @ )。 


下 面 是 导航 栏 定义 代码 的 最 后 一 部 分 : 


base.himl -- Snip-- 
</U]> 
© <ul class="navbar-nav ml-auto"> 
@ {% if user.is authenticated %} 
<li class="nav-item"> 
© <span class="navbar-text">Hello, {{ user.username }}.</span> 
</1i> 


<1li class="nav-item"> 
<a class="nav-link" href="{% Url 'users:logout' %}">Log out</a> 
</1i> 
{% else %} 
<1li class="nav-item"> 
<a class="nav-link" href="{% url 'users:register' %}">Register</a> 
</1i> 
<1li class="nav-item"> 
<a class="nav-link" href="{% url 'users:login' %}">Log in</a></1i> 
{% endif %} 
</ul> 
@ ‘</div> 


</nav> 


@ 处 使 用 起 始 标签 cul> 定 义 了 另 一 组 链接 ( 你 可 根据 需要 在 页 面 中 包含 任意 数量 的 链接 编 
组 )， 这 组 链接 与 登录 和 注册 相关 ， 出 现在 导航 栏 最 右 端 。 选 择 器 mL-auto 表示 自动 左边 距 
( margin-left-automatic ), 它 根据 导航 栏 包 含 的 其 他 元 素 设置 左边 距 , 确保 这 组 链接 位 于 屏幕 右边 。 20 
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@ 处 的 if 代码 块 与 以 前 使 用 的 条 件 代 码 块 相同 ， 它 根据 用 户 是 否 已 登录 显示 相应 的 消息 。 
这 个 代码 块 比 以 前 长 一 些 ， 因 为 它 现在 包含 一 些 样式 规则 。@ 处 是 一 个 <span> 元 素 ， 用 于 设置 区 
域内 一 系列 文本 或 元 素 的 样式 。 这 起 初 可 能 令 人 迷惑 : 为 什么 不 能 套 <div> 呢 ? 毕竟 有 很 多 页 面 
深度 般 套 了 <div> 元 素 。 这 是 因为 <div> 元 素 创建 区 域 ， 而 <span> 元 素 不 会 。 这 里 只 是 要 设置 导航 
栏 中 信息 性 文本 ( 如 已 登录 用 户 的 名 称 ) 的 样式 ， 旨 在 让 其 外 观 与 链接 不 同 ， 以 免 用 户 忍 不 住 去 
单 击 ， 因 此 使 用 了 <span>。 


@ 处 指出 <div> 元 素 ( 它 包 含 将 在 屏幕 太守 时 折 和 县 起 来 的 导航 栏 部 分 ) 到 此 结束 ， 然 后 指出 
整个 导航 栏 到 此 结束 。 要 在 导航 栏 中 添加 其 他 链接 ， 可 在 既 有 的 <ul> 元 素 中 添加 <1i> 元 素 ， 并 使 
用 这 里 演示 的 样式 设置 指令 。 

在 base.html 中 ， 还 需 添 加 一 些 代 码 : 定义 两 个 块 ， 供 各 个 页 面 放置 其 特有 的 内 容 。 

3. 定义 页 面 的 主要 部 分 

base.html 的 余下 部 分 包含 页 面 的 主要 部 分 : 


base.himl -507p== 


</nav> 


@ “main role="main" class="container"> 
2 «<div class="pb-2 mb-2 border-bottom"> 
{% block page header %}{% endblock page header %} 
</div> 
© <div> 
{% block content %}{% endblock content %} 
</div> 
</main> 


</body> 


</html> 


@ 处 是 一 个 <main> 起 始 标签 。<main> 元 素 用 于 定义 页 面 主 体 的 最 重要 部 分 。 此 处 指定 了 
Bootstrap 选择 器 container， 这 是 一 种 对 页 面 元 素 进行 编组 的 简单 方式 。 我 们 将 在 这 个 容器 中 放 
置 两 个 <div> 元 素 。 


第 一 个 <div> 元 素 ( 见 @ ) 包含 一 个 page_header 块 ， 我 们 会 在 大 多 数 页 面 中 使 用 它 来 指定 标 
题 。 为 突出 标题 ， 设 置 内 边 距 。 内 边 距 (padding ) 指 的 是 元 素 内 容 和 边框 之 间 的 距离 。 选 择 回 
pb-2 是 一 个 Bootstrap 指令 ， 将 元 素 的 下 内 边 距 设置 为 适度 的 值 。 外 边 距 ( margin ) 指 的 是 元 素 的 
边框 与 其 他 元 素 之 间 的 距离 。 我 们 只 想 在 标题 下 面 添加 边框 ， 因 此 使 用 选择 器 border-bottom， 它 
在 page_header 块 的 下 面 添加 较 细 的 边框 。 


@ 处 定义 了 另 一 个 <div> 元 素 , 其 中 包含 content 块 。 我 们 没有 对 这 个 块 指 定 样 式 ， 因 此 在 具 
体 的 页 面 中 ， 可 根据 需要 设置 内 容 的 样式 。 文 件 base.html 的 末尾 是 元 素 <main> 、<body> 和 <htm1> 
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的 结束 标签 。 

如 果 现 在 在 浏览 器 中 加 载 “ 学 习 笔 记 ” 的 主页 ， 你 将 看 到 一 个 类 似 于 图 20-1 所 示 的 专业 级 
导航 栏 。 请 尝试 将 窗口 调整 得 非常 窑 ， 此 时 导航 栏 将 变 成 一 个 按钮 。 如 果 你 单 击 这 个 按钮 ， 将 打 
开 一 个 下 拉 列 表 ， 其 中 包含 所 有 的 导航 链接 。 


20.1.4 使 用 jumbotron 设置 主页 的 样式 


下 面 使 用 Bootstrap 元 素 jumbotron 来 修改 主页 。jumbotron 元 素 是 一 个 大 框 ， 在 页 面 中 显得 稚 
立 鸡 群 。 它 可 以 包含 任何 东西 ， 通 常用 于 在 主页 中 呈现 简要 的 项 目 描述 和 让 用 户 行动 起 来 的 元 素 。 


修改 后 的 文件 index.html 如 下 所 示 : 


index.him! {% extends "learning logs/base.html" %} 


@ {% block page header %} 
四 “div class="jumbotron"> 
3 <h1 class="display-3">Track your learning.</h1> 


Q <p class="lead">Make your own Learning Log, and keep a list of the 
topics you're learning about. Whenever you learn something new 
about a topic, make an entry summarizing what you've learned.</p> 


© <a class="btn btn-lg btn-primary" href="{% url 'users:register' %}" 
role="button">Register &raquo;</a> 
</div> 
@ {% endblock page header %} 


在 @ 人 处， 告诉 Django 接 下 来 要 定义 page_header 块 包含 的 内 容 。jumbotron 就 是 应 用 了 一 系 
列 样式 设置 指令 的 <div> 元 素 ( 见 @ )。 这 里 使 用 选择 器 jumbotron 应 用 这 组 来 自 Bootstrap 库 的 样 
式 设置 指令 。 

这 个 jumbotron 包含 三 个 元 素 。 第 一 个 是 一 条 简短 的 消息 Track your learning， 让 首次 访 
问 者 大 致知 道 “学 习 笔记 ”是 做 什么 用 的 。h1 类 表示 一 级 标题 ， 而 选择 器 display-3 让 这 个 标题 
显得 更 窗 更 高 ( 见 @ )。 在 @ 处 添加 一 条 更 长 的 消息 ， 让 用 户 更 详细 地 知道 使 用 学 习 笔 记 可 以 做 
什么 。 


在 @ 处 ， 通 过 创建 一 个 按钮 ( 而 不 是 文本 链接 ) 邀请 用 户 注 册 账 户 。 它 与 导航 栏 中 的 链接 
Register 一 样 链接 到 的 注册 页 面 ， 但 是 按钮 更 显眼 ， 并 且 让 用 户 知 道 要 使 用 这 个 项 目 首先 需要 如 
何 做 。 这 里 的 选择 器 让 这 个 按钮 很 大 ， 召唤 用 户 赶 快 行动 起 来 。 代 码 &raquo; 是 一 个 HTML 实体 ， 
表示 两 个 右 尖 括 号 (>> )。 在 @ 处 ,结束 page_header 块 。 我 们 不 想 在 这 个 页 面 中 添加 其 他 内 容 ， 
因此 不 需要 定义 content 块 。 


现在 的 主页 类 似 于 图 20-1 所 示 ， 比 设置 样式 前 有 很 大 的 改进 。 20 


404 第 20 章 设置 应 用 程序 的 样式 并 部 署 


20.1.5 ”设置 登录 页 面 的 样式 


我 们 改进 了 登录 页 面 的 整体 外 观 ， 但 还 未 改进 登录 表单 。 下 面 来 修改 文件 login.html， 让 表 
单 与 页 面 的 其 他 部 分 一 致 : 


login.him! {% extends "learning logs/base.html" %} 
@ {% load bootstrap4 %} 


@ {% block page header %} 
<h2>Log in to your account.</h2> 
{% endblock page header %} 


{% block content %} 
@ <form method="post" action="{% url 'users:login' %}" class="form"> 
{% csrf token %} 
@ {% bootstrap form form %} 
© {% buttons %} 
<button name="submit" class="btn btn-primary">Log in</button> 
{% endbuttons %} 


<input type="hidden" name="nNext" 
value="{% url 'learning logs:index' %}" /> 


</form> 


{% endblock content %} 


在 @ 人 处, 我们 在 这 个 模板 中 加 载 bootstrap4 模板 标签 。 在 @ 处 , 定义 page_header 块 , 指出 这 
个 页 面 是 做 什么 用 的 。 注 意 ， 我 们 从 这 个 模板 中 删除 了 代码 块 {% if form.errors %}， 因 为 
django-bootstrap4 会 自动 管理 表单 错误 误 。 


在 @ 处 ,添加 属性 class="form" ， 再 使 用 模板 标签 {% bootstrap_form %} 来 显示 表单 ( 见 @ )， 
它 替 换 了 第 19 章 使 用 的 标签 {{ form.as_p }}。 模 板 标 签 {% booststrap_form %} 将 Bootstrap 样式 
规则 应 用 于 各 个 表单 元 素 。@ 处 是 bootstrap4 起 始 模板 标签 {% buttons %}， 它 将 Bootstrap 样式 
应 用 于 按钮 。 


图 20-2 显示 了 现在 泻 染 的 登录 表单 。 这 个 页 面 比 以 前 整洁 得 多 ， 且 风格 一 致 、 用 途 明确 。 
如 果 你 尝试 使 用 错误 的 用 户 名 或 密码 登录 ,将 发 现 消息 的 样式 与 整个 网 站 一 致 ， 完 美 地 融入 了 
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[TY 田 localhost [ ©, 口 敬 


Learning Log Topics Register Log in 


Log in to your account. 


Username 
Username 各 
Password 


Password 


图 20-2 ”使 用 Bootstrap 设置 样式 后 的 登录 页 面 


20.1.6 ”设置 显示 所 有 主题 的 页 面 的 样式 
下 面 来 确保 用 于 查看 信息 的 页 面 也 有 合适 的 样式 ， 首 先 来 设置 显示 所 有 主题 的 页 面 : 


topics.him! {% extends "learning logs/base.html" %} 


@ {% block page header %} 
<h1>Topics</h1> 
{% endblock page header %} 


{% block content %} 
<U]> 
{% for topic in topics %} 
@ <]i><h3> 
<a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a> 
</h3></1i> 
{% empty %} 
<li><h3>No topics have been added yet.</h3></1i> 
{% endfor %} 
</ul> 


@ “h3><a href="{% url 'learning logs:new topic' %}">Add a new topic</a></h3> 
{% endblock content %} 


不 需要 标签 {% load bootstrap4 %}， 因 为 这 个 文件 中 没有 使 用 任何 bootstrap4 自 定义 标签 。 
我 们 将 标题 Topics 移 到 page_header 块 中 ， 并 给 它 指定 标题 样式 ， 而 没有 使 用 简单 的 段落 标签 
( 见 @ )。 将 每 个 主题 都 设置 为 ch3> 元 素 ， 使 其 在 页 面 上 显得 大 一 些 ( 见 @ )。 对 于 添加 新 主题 的 


链接 ， 也 做 同样 的 处 理 ( 见 @ ) 20 
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20.1.7 ”设置 显示 单个 主题 的 页 面 中 的 条 目 样 式 


比 起 大 部 分 页 面 , 显示 单个 主题 的 页 面包 含 更 多 内 容 , 因此 需要 做 的 样式 设置 工作 要 更 多 一 
些 。 我 们 将 使 用 Bootstrap 的 卡片 (card ) 组 件 来 突出 每 个 条 目 。 卡 片 是 带 灵活 的 预定 义 样式 的 <div>， 


非常 适合 用 


于 显示 主题 的 条 目 : 


topic.him!l {% extends 'learning logs/base.html' %} 


@ {% block page header %} 
<h3>{{ topic }}</h3> 
{% endblock page header %} 


{% bloc 


k content %} 


<a href="{% url 'learning logs:new entry' topic.id %}">Add new entry</a> 


{% for entry in entries %} 
@ <div class="card mb-3"> 


© <h4 


class="card-header"> 


{{ entry.date added|date:'M d, Y H:i' }} 
M49 <small><a href="{% url 'learning logs:edit entry' entry.id %}"> 


edit entry</a></small> 


</h4> 
© <div class="card-body"> 


{{ entry.text|linebreaks }} 


</div> 
</div> 
{% empty %} 


<p>T 


here are no entries for this topic yet.</p> 


{% endfor %} 


{% endb] 


ock content %} 


首先 将 主题 放 在 page_header 块 中 ( 见 @ ), 并 删除 该 模板 中 以 前 使 用 的 无 序列 表 结 构 。 在 @ 
处 ， 创 建 一 个 带 选 择 器 card 的 <div> 元 素 ( 而 不 是 将 每 个 条 目 作 为 一 个 列表 项 )， 其 中 包含 两 个 


组 套 的 元 素 


: 一 个 包含 条 目的 创建 日 期 以 及 用 于 编辑 条 目的 链接 ， 男 一 个 包含 条 目的 内 容 。 


骨 套 的 第 一 个 元 素 是 个 标题 。 它 是 带 选 择 器 card-header 的 <h4> 元 素 ( 见 @ ), 包含 条 目的 创 
建 日 期 以 及 用 于 编辑 条 目的 链接 。 用 于 编辑 条 目的 链接 放 在 标签 <smal1> 内 ， 这 让 它 看 起 来 比 时 


间 蕉 小 一些 


( 见 @ ),。 第 二 个 垦 套 的 元 素 是 一 个 带 选 择 器 card-body 的 <div> 元 素 ( 见 @ ), 将 条 日 


的 内 容 放 在 一 个 简单 的 框 内 。 注 意 我 们 只 修改 了 影响 页 面 外 观 的 元 素 ， 对 在 页 面 中 包含 信息 的 
Django 代码 未 做 任何 修改 。 


图 20-3 


显示 了 修改 后 的 单个 主题 页 面 。 “学习 笔 记 ” 的 功能 没有 任何 变化 ,但 显得 更 专业 ， 


对 用 户 更 有 吸引 力 。 
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[2 < 加 © localhost8000Hrtopics ey | 四 由 = i 
Learning Log Topics Hello, ll_admin. Log out 
Chess 


Add new entry 
Feb 19, 2019 07:07 edit entry 
The bishops and knights are good pieces to have out in the opening phase of the game. They're both powerful enough to 
be useful in attacking your opponent, but not so powerful that you can't afford to lose them in an early trade. 
Feb 19, 2019 02:06 edit entry 
In the opening phase of the game, it's important to bring out your bishops and knights. These pieces are powerful and 
maneuverable enough to play a significant role in the beginning moves of a game. 
Feb 19, 2019 02:06 edit entry 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it's a good idea to do three 
things 一 bring out your bishops and knights, try to control the center of the board, and castle your king. 


Of course thase arej 


图 20-3 使 用 Bootstrap 设置 样式 后 的 单个 主题 页 醒 


注意 要 使 用 其 他 Bootstrap 模板 ， 可 采用 与 本 章 类 似 的 流程 : 将 要 使 用 的 模板 复制 到 base.html 
中 并 修改 包含 实际 内 容 的 元 素 ， 以 使 用 该 模板 来 显示 项 目的 信息 ， 然 后 使 用 Bootstrap 的 
样式 设置 工具 来 设置 各 个 页 面 中 内 容 的 样式 。 


动手 试 一 斌 
练习 20-1: 其 他 表单 ”本 节 对 登录 页 面 应 用 了 Bootstrap 样式 。 请 对 其 他 基于 表单 的 


页 面 做 类 似 的 修改 , 包括 new topic 页 面 、 new entry 页 面 、edit entry 页 面 和 注册 页 面 。 


练习 20-2: 设置 博客 的 样式 ”对 于 你 在 第 19 章 创建 的 项 目 Blog, 使 用 Bootstrap 来 
设置 其 样式 。 


20.2 部署 “学 习 笔记 ” 


至 此 , 项 目 “ 学 习 笔记 ”的 外 观 显 得 很 专业 ， 下 面 将 其 部 署 到 服务 器 ， 让 任何 有 互联 网 连接 
的 人 都 能 够 使 用 它 。 为 此 ， 我 们 将 使 用 Heroku。 这 是 一 个 基于 Web 的 平台 ， 供 我 们 管理 Web 应 
用 程序 的 部 署 。 我 们 将 让 “学 习 笔 记 ” 在 Heroku 上 运行 起 来 。 
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20.2.1 建立 Heroku 账户 


要 建立 账户 ,请 访问 Heroku 官方 网 站 ,并 单 击 其 中 一 个 注册 链接 。 注 册 账 户 是 免费 的 , Heroku 
提供 的 免费 试用 服务 〈 free tier ) 让 你 能 够 将 项 目 部 署 到 服务 器 并 对 其 进行 测试 。 


注意 ”Heroku 提供 的 免费 试用 服务 存在 一 些 限制 ， 如 可 部 署 的 应 用 程序 数量 以 及 用 户 访问 应 用 
程序 的 频率 。 但 这 些 限制 都 很 宽松 ， 让 你 能 够 在 不 支付 任何 费用 的 情况 下 练习 部 署 应 用 
程序 。 


20.2.2 ”安装 Heroku CLI 


要 将 项 目 部 署 到 Heroku 的 服务 器 并 对 其 进行 管理 ， 需 要 使 用 Heroku CLI (Command Line 
Interface ， 命 令 行 界 面 ) 提供 的 工具 。 要 安装 最 新 的 Heroku CLI 版 本 ， 请 访问 Heroku Dev Center 
网 站 的 The Heroku CLI 页 面 , 并 根据 你 使 用 的 操作 系统 按 相 关 的 说 明 做 : 使 用 只 包含 一 行 的 终端 
命令 或 下 载 并 运行 安装 程序 。 


20.2.3 ”安装 必要 的 包 


我 们 还 需 安 装 三 个 包 ， 以 便 在 服务 器 上 支持 Django 项 目 提 供 的 服务 。 为 此 ， 在 活动 状态 的 
虚拟 环境 中 执行 如 下 命令 : 


(11_env)learning log$ pip install psycopg2==2.7.* 
(1] env)learning log$ pip install django-heroku 
(11_env)learning log$ pip install gunicorn 


为 管理 Heroku 使 用 的 数据 库 ，psycopg? 包 必 不 可 少 。django-heroku 包 用 于 管理 应 用 程序 的 
各 种 配置 ， 使 其 能 够 在 Heroku 服务 器 上 正确 地 运行 。 这 包括 管理 数据 库 ， 以 及 将 静态 文件 存储 
到 合适 的 地 方 ， 以 便 能 够 妥善 地 提供 它们 。 静 态 文件 包括 样式 规则 和 JavaScript 文件 。gunicorn 
包 让 服务 器 能 够 实时 地 支持 应 用 程序 。 


20.2.4 创建 文件 requirements.txt 


Heroku 需要 知道 项 目 依赖 于 哪些 包 ， 因 此 我 们 使 用 pip 生成 一 个 文件 ， 在 其 中 列 出 这 些 包 。 
同样 ， 进 入 活动 虚拟 环境 ， 并 执行 如 下 命令 : 


(1] env)learning log$ pip freeze > requirements.txt 


命令 freeze 让 pip 将 项 目 中 当前 安装 的 所 有 包 的 名 称 都 写 入 文件 requirements.txt。 请 打开 文 
件 requirements.txt， 查 看 项 目 中 安装 的 包 及 其 版 本 : 
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requirements. txt dj -database-url==0.5.0 
Django==2.2.0 
django-bootstrap4==0.0.7 
django-heroku==0.3.1 
gunicorn==19.9.0 
psycopg2==2.7.7 
pytz==2018.9 
sqlparse==0.2.4 
whitenoise==4.1.2 


“学 习 笔记 ”依赖 于 8 个 特定 版 本 的 包 ， 因 此 在 相应 的 环境 中 才能 正确 地 运行 。 在 这 8 个 包 
中 ， 有 4 个 是 我 们 手工 安装 的 ， 余 下 的 4 个 是 作为 依赖 的 包 自 动 安装 的 。 

我 们 部 署 “ 学 习 笔 记 ” 时 ，Heroku 将 安装 requirements.txt 列 出 的 所 有 包 ， 从 而 创建 一 个 
环境 ， 其 中 包含 在 本 地 使 用 的 所 有 包 。 有 鉴于 此 ， 我 们 可 以 深信 在 部 署 到 Heroku 后 ， 项 目的 行 
为 将 与 在 本 地 系统 上 完全 相同 。 当 你 在 自己 的 系统 上 开发 并 维护 各 种 项 目 时 , 这 将 是 一 个 巨大 的 
优点 。 


注意 ”如果 在 你 的 系统 中 , requirements.txt 列 出 的 包 的 版 本 与 上 面 列 出 的 不 同 , 请 保留 原来 的 版 
本 号 。 
20.2.5 ”指定 Python 版 本 


如 果 没 有 指定 Python 版 本 ，Heroku 将 使 用 其 当前 的 Python 默认 版 本 。 下 面 来 确保 Heroku 
使 用 我 们 使 用 的 Python 版 本 。 为 此 ， 在 活动 状态 的 虚拟 环境 中 ， 执 行 命令 python --version: 


(11 _env)learning log$ python --version 
Python 3.7.2 


上 述 输出 表明 ， 我 使 用 的 是 Python 3.7.2。 请 在 manage.py 所 在 的 文件 夹 中 新 建 一 个 名 为 
runtime.txt 的 文件 ， 并 在 其 中 输入 如 下 内 容 : 


runtime.txt python-3.7.2 


这 个 文件 应 只 包含 一 行内 容 ， 以 上 面 所 示 的 格式 指定 你 使 用 的 Python 版 本 。 请 确保 输入 小 
写 的 python， 在 它 后 面 输入 一 个 连 字符 ， 再 输入 由 三 部 分 组 成 的 版 本 号 。 


注意 ”如果 出 现 错误 消息 ,指出 不 能 使 用 指定 的 Python 版 本 ,请 访问 Heroku Dev Center 网 站 的 
Language Support 页 面 ， 再 单 击 到 Specifying a Python Runtime 的 链接 。 浏 览 打开 的 文章 ， 
了 解 支持 的 Python 版 本 ， 并 使 用 与 你 使 用 的 Python 版 本 最 接近 的 版 本 。 
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20.2.6 “为 部 署 到 Heroku 而 修改 settings.py 
现在 需要 在 settings.py 末尾 添加 一 个 片段 ， 在 其 中 指定 一 些 Heroku 环境 设置 : 


settings.py -- 511p-- 
# 我 的 设置 


LOGIN URL = 'users:login’ 


# Heroku 设置 
import django_heToku 
django_heroku. settings(locals()) 


这 里 导入 了 模块 django_heroku 并 调用 了 函数 settings()。 这 个 函数 将 一 些 设置 修 改 为 Heroku 
环境 要 求 的 值 。 
20.2.7 ”创建 启动 进程 的 Procfile 


Procfile 告诉 Heroku 应 该 启动 哪些 进程 ,以 便 正确 地 提供 项 目 需 要 的 服务 。 请 将 这 个 只 包含 
一 行 代码 的 文件 命名 为 Procfile ( 首 字母 P 为 大 写 ), 但 不 指定 文件 扩展 名 ， 再 将 其 保存 到 manage.py 
所 在 的 目录 中 。 


Procfile 的 内 容 如 下 : 


Procfile web: gunicorn learning log.wsgi --log-file - 


这 行 代码 让 Heroku 将 Gunicorn 用 作 服 务 器 ， 并 使 用 learning log/wsgi.py 中 的 设置 来 启动 应 
用 程序 。 标 识 log-file 告诉 Heroku 应 将 哪些 类 型 的 事件 写 人 日 志 。 


20.2.8 使 用 Git 跟踪 项 目 文件 

第 17 章 说 过 ，Git 是 一 个 版 本 控制 程序 ,让 你 能 够 在 每 次 成 功 实 现 新 功能 后 都 拍摄 项 目 代码 
的 快照 。 无 论 出 现 什么 问题 ( 如 实现 新 功能 时 不 小 心 引 入 了 bug )， 都 可 轻松 地 恢复 到 最 后 一 个 
可 行 的 快照 。 每 个 快照 都 称 为 提交 。 

使 用 Git 意味 着 在 尝试 实现 新 功能 时 无 须 担 心 破坏 项 目 。 将 项 目 部 署 到 服务 器 时 ， 需 要 确保 
部 署 的 是 可 行 版 本 。 要 更 详细 地 了 解 Git 和 版 本 控制 ， 请 参阅 附录 D。 

1. 安装 Git 

在 你 的 系统 中 ， 可 能 已 经 安装 了 Git。 要 确定 是 否 安 装 了 Git, 可 打开 一 个 新 的 终端 窗口 ， 并 
在 其 中 执行 命令 git --version: 


(1] env)learning log$ git --version 
git version 2.17.0 
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如 果 由 于 某 种 原因 出 现 了 错误 消息 ， 请 参阅 附录 D 中 的 Git 安装 说 明 。 


2. 配置 Git 


Git 跟踪 是 谁 修改 了 项 目 ， 即 便 项 目 由 一 个 人 开发 亦 如 此 。 为 进行 跟踪 ，Git 需 要 知道 你 的 用 
户 名 和 电子 邮箱 。 因 此 ， 你 必须 提供 用 户 名 ， 但 对 于 练习 项 目 ， 可 以 编造 一 个 电子 邮箱 : 


Te 
i 


1 env)learning log$ git config --global user.name "ehmatthes" 
_env)learning log$ git config --global user.email "eric@example.com" 


Zs 
0 


如 果 忘 记 了 这 一 步 ， 首 次 提交 时 Git 将 提示 你 提供 这 些 信息 。 


3. 忽略 文件 

无 须 让 Git 跟踪 项 目 中 的 每 个 文件 ， 因 此 我 们 让 它 忽 略 一 些 文件 。 在 manage.py 所 在 的 文件 
夹 中 创建 一 个 名 为 .gitignore 的 文件 〈 请 注意 ， 这 个 文件 名 以 句点 打头 ， 且 不 包含 扩展 名 )， 并 在 
其 中 输入 如 下 代码 : 


.gitignore 11 env/ 
_ pycache _/ 
*.sqlite3 


这 里 让 Git 忽略 目录 11_env, 因为 随时 都 可 自动 重新 创建 它 ,还 指定 不 跟踪 目录 pycache ， 
这 个 目录 包含 Django 运行 .py 文件 时 自动 创建 的 .pyc 文件 。 我 们 没有 跟踪 对 本 地 数据 库 的 修改 ， 
因为 这 是 个 坏 习 惯 : 如 果 在 服务 器 上 使 用 的 是 SQLite, 将 项 目 推送 到 服务 器 时 , 可 能 会 不 小 心 用 
本 地 测试 数据 库 覆 羡 在 线 数据 库 。*.sqlite3 让 Git 忽略 所 有 扩展 名 为 .sqlite3 的 文件 。 


注意 ”如果 你 使 用 的 是 macOS 系统 ， 请 将 .DS_Store 添加 到 文件 .gitignore 中 。 文 件 .DS_Store 存 
储 的 是 有 关 文 件 夹 设置 的 信息 ， 与 这 个 项 目 一 点 关系 都 没有 。 


4. 显示 隐藏 的 文件 


大 多 数 操作 系统 都 会 隐藏 名 称 以 句点 打头 的 文件 和 文件 来， 如 .gitignore。 当 你 打开 文件 浏览 
器 或 在 诸如 Sublime Text 等 应 用 程序 中 打开 文件 时 ， 默 认 看 不 到 隐藏 的 文件 。 

不 过 作为 程序 员 ， 你 需要 看 到 它们 。 下 面 说 明了 如 何 显示 隐藏 的 文件 。 

口 在 Windows 系统 中 ， 打 开 资 源 管理 器 ， 再 打开 一 个 文件 来， 如 Desktop。 单 击 标签 View 
(查看 )， 并 确保 选中 了 复 选 框 File name extensions ( 文件 扩展 名 ) 和 Hidden items ( 隐藏 
的 项 目 )。 

口 在 macOS 系统 中 ， 要 显示 隐藏 的 文件 和 文件 严 ， 可 在 文件 浏览 器 窗口 中 按 Command + 
Shift+. (句点 )。 
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口 在 Ubuntu 等 Linux 系统 中 ， 可 在 文件 浏览 器 中 按 Ctrl + 互 来 显示 隐藏 的 文件 和 文件 夹 。 
为 让 这 种 设置 为 永久 性 的 ， 可 打开 文件 浏览 器 (如 Nautilus )， 再 单 击 选项 标签 ( 以 三 条 
线 表示 )， 并 选中 复 选 框 Show Hidden Files ( 显示 隐藏 的 文件 )。 


5. 提交 项 目 


我 们 需要 为 “学 习 笔记 ”初始 化 一 个 Git 仓库 


， 将 所 有 必要 的 文件 都 加 入 该 仓库 ， 并 提交 项 


TT 


目的 初始 状态 ， 如 下 所 示 : 


@ (]1 env)learni 
Initi 
@ (ll env)learni 
©@ (]1 env)learni 
[mas 


@ (ll1 env)learni 


ng log$ git init 

alized empty Git repository in /home/ehmatthes/pcc/learning log/ .git/ 
ng log$ git add . 

ng log$ git commit -am "Ready for deployment to heroku." 

ter (root-commit) 79fef72] Ready for deployment to heroku. 


45 files changed, 712 insertions(+) 


create mode 100644 


.gitignore 


create mode 100644 Procfile 


-- Snip-- 


create mode 100644 users/views.py 


On branch master 
nothing to commit, working tree clean 


(11 env)learni 


ng log$ git status 


ng log$ 


在 @ 处 ， 执 行 命令 git in 让 ， 在 “学 习 笔 记 ” 所 在 的 目录 中 初始 化 一 个 空仓 库 。 在 @@ 处 ， 执 
行 命令 git add .( 千 万 别 忘 了 这 个 句点 )， 将 未 被 忽略 的 文件 都 加 入 这 个 仓库 。 在 人 @ 处 ， 执 行 命 


令 git commit -am commit message， 其 中 的 标志 -a 让 Git 在 这 个 提交 中 包含 所 有 修改 过 的 文件 ， 


T 


而 标志 -m 让 Git 记录 一 条 日 志 消 息 。 


在 @ 处 ,执行 命令 git status, 输出 表明 当前 位 于 分 支 master， 而 工作 树 是 干净 (clean ) 的 。 
每 当 要 将 项 目 推送 到 Heroku 时 ， 我 们 都 希望 看 到 这 样 的 状态 。 


20.2.9 推送 到 Heroku 
终于 可 以 将 项 目 推送 到 Heroku 了 。 在 活动 的 虚拟 环境 中 ， 执 行 下 面 的 命令 : 


@ ( 


et sa ee 


1] env)learning log 
ogging in... done 
1] env)learning log 


https://git.hero 
1] env)learning log 


-- Snip-- 
remote: ----- > Launching... 


heroku login 


eroku: Press any key to open up the browser to login or q to exit: 


ogged in as eric@example.com 


heroku create 


reating app... done, @ secret-lowlands-82594 
ttps://secret-lowlands-82594.herokuapp.com/ 


u.com/secret-lowlands-82594.git 
git push heroku master 
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remote: Released v5 
@ remote: https://secret-lowlands-82594.herokuapp.com/ deployed to Heroku 
remote: Verifying deploy... done. 
To https://git.heroku.com/secret-lowlands-82594.git 
* [new branch] master -> master 
(11 env)learning log$ 


首先 执行 命令 heroku login, 这 将 打开 浏览 器 并 在 其 中 显示 一 个 页 面 , 让 你 能 够 登录 Heroku 
( 见 @ )。 然 后 ， 让 Heroku 创建 一 个 空 项 目 ( 见 @ )。Heroku 生成 的 项 目 名 由 两 个 单词 和 一 串 数字 
组 成 ， 但 以 后 可 修改 这 个 名 称 。 接 下 来 ， 执 行 命令 git push heroku master ( 见 @ )， 让 Git 将 项 
目的 分 支 master 推送 到 Heroku 刚才 创建 的 仓库 中 。Heroku 将 使 用 这 些 文件 在 其 服务 器 上 创建 项 
目 。@ 处 列 出 了 用 于 访问 这 个 项 目的 URL, 但 这 个 URL 和 项 目 名 都 是 可 以 修改 的 。 

执行 这 些 命令 后 ,项 目 就 部 署 好 了 ， 但 还 未 做 全 面 配 置 。 为 核实 正确 地 启动 了 服务 器 进程 ， 


请 执行 命令 heroku ps: 


(11 env)learning log$ heroku ps 

@ Free dyno hours quota remaining this month: 450h 44m (81%) 
Free dyno usage for this app: Oh om (0%) 
For more information on dyno sleeping and how to upgrade, see: 
https://devcenter.heroku.com/articles/dyno-sleeping 

@ === web (Free): gunicorn learning log.wsgi --log-file - (1) 
web.1: up 2019/02/19 23:40:12 -0900 (~ 10m ago) 
(11 env)learning log$ 


输出 指出 了 在 接 下 来 的 一 个 月 内 ,项 目 还 可 在 多 长 时 间 内 处 于 活动 状态 ( 见 @ )。 编 写本 书 
时 , Heroku 允许 免费 部 署 在 一 个 月 内 最 多 有 550 小 时 处 于 活动 状态 。 项 目的 活动 时 间 超 过 这 个 限 
制 后 ,将 显示 标准 的 服务 器 错误 页 面 ， 我 们 稍 后 将 定制 这 个 错误 页 面 。 在 @ 人 处 ,我 们 发 现 启 动 了 
Procfile 指定 的 进程 。 

现在 ， 可 使 用 命令 heroku open 在 浏览 器 中 打开 这 个 应 用 程序 了 : 


(11 env)learning log$ heroku open 
(11 env)learning log$ 


也 可 以 启动 浏览 器 并 输入 Heroku 告诉 你 的 URL, 但 上 述 命令 让 你 无 须 这 样 做 。 你 将 看 
到 “学 习 笔 记 ” 的 主页 ， 其 样式 设置 正确 无 误 ， 但 还 无 法 使 用 这 个 应 用 程序 ， 因 为 尚未 建立 
数据 库 。 


注意 部署 到 Heroku 的 流程 会 不 断 变 化 。 如 果 遇 到 无 法 解决 的 问题 ， 请 通过 查看 Heroku 文档 
来 获取 帮助 ,为 此 ,可 访问 Heroku Dev Center 网 站 首页 , 单 击 Python, 再 单 击 到 Get Started 
with Python 或 Deploying Python and Django Apps on Heroku 的 链接 。 如 果 看 不 懂 这 些 文档 ， 
请 参阅 附录 C 提供 的 建议 。 
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20.2.10 在 Heroku 上 建立 数据 库 


为 建立 在 线 数据 库 ， 需 要 再 次 执行 命令 migrate， 并 应 用 在 开发 期 间 生 成 的 所 有 迁移 。 要 对 
Heroku 项 目 执行 Django 和 Python 命令 ， 可 使 用 命令 heroku fun。 下 面 演示 了 如 何 对 Heroku 部 
署 执行 命令 migrate: 


@ (ll env)learning log$ heroku run python manage.py migrate 
@ Running 'python manage.py migrate' on @ secret-lowlands-82594... up, run.3060 
-- Snip-- 
四 Running migrations: 
-- Snip-- 
Applying learning logs.0001 initial... OK 
Applying learning logs.0002 entry... OK 
Applying learning logs.0003 topic owner... OK 
Applying sessions.0001 initial... OK 
(1] env)learning log$ 


首先 执行 命令 heroku run python manage.py migrate ( 见 @ )。Heroku 随后 创建 一 个 终端 会 
话 来 执行 命令 migrate ( 见 @ ),。 在 @ 处 ，Django 应 用 默认 迁移 以 及 我 们 在 开发 “学 习 笔 记 ” 期 间 
生成 的 迁移 。 

现在 如 果 访 问 这 个 部 署 的 应 用 程序 , 将 能 够 像 在 本 地 系统 上 一 样 使 用 它 , 但 看 不 到 在 本 地 部 
署 中 输入 的 任何 数据 ( 包括 超级 用 户 账户 )， 因 为 它们 还 没有 被 复制 到 在 线 服 务 器 。 通 常 ， 不 将 
本 地 数据 复制 到 在 线 部 署 中 ， 因 为 本 地 数据 通常 是 测试 数据 。 


你 可 分 享 “ 学 习 笔记 ”的 Heroku URL， 让 任何 人 都 可 使 用 它 。 下 一 广 将 再 完成 儿 个 任务 ， 
以 结束 部 署 过 程 ， 让 你 能 够 继续 开发 “学 习 笔记 ”。 


20.2.11 改进 Heroku 部 署 


本 节 将 通过 创建 超级 用 户 来 改进 部 署 ， 就 像 在 本 地 一 样 。 我 们 还 将 让 这 个 项 目 更 安全 : 将 
DEBUG 设置 为 False， 让 用 户 在 错误 消息 中 看 不 到 额外 的 信息 ， 以 防 其 利用 这 些 信息 来 攻击 服务 器 。 

1. 在 Heroku 上 创建 超级 用 户 

我 们 知道 可 以 使 用 命令 heroku run 来 执行 一 次 性 命令 ,但 也 可 这 样 执行 命令 :在 连接 到 Heroku 
服务 器 的 情况 下 ， 使 用 命令 heroku run bash 打开 Bash 终端 会 话 。Bash 是 众多 Linux 终端 运行 的 
语言 。 我 们 将 使 用 Bash 终端 会 话 来 创建 超级 用 户 ， 以 便 访问 在 线 应 用 程序 的 管理 网 站 : 


(11 env)learning log$ heroku run bash 
Running 'bash' on ®@ secret-lowlands-82594... up, run.9858 
©~$1s 
learning log learning logs manage.py Procfile requirements.txt runtime.txt 
staticfiles users 
@ ~ $ python manage.py createsuperuser 
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Username (leave blank to use ' u47318'): 1] admin 
Email address: 
Password: 
Password (again): 
Superuser created successfully. 
© ~$ exit 
exit 
(11 env)learning log$ 


在 @ 处 , 执行 命令 1s, 以 查看 服务 器 上 有 哪些 文件 和 目录 。 服务器 包含 的 文件 和 目录 应 与 本 
地 系统 相同 。 可 像 遍历 其 他 文件 系统 一 样 遍历 这 个 文件 系统 。 


注意 ”即便 使 用 的 是 Windows 系统 ， 也 应 使 用 这 里 列 出 的 命令 (如 1s 而 不 是 djir )， 因 为 这 里 
是 在 通过 远程 连接 运行 Linux 终端 。 

在 @ 处 ,执行 创建 超级 用 户 的 命令 ， 它 像 第 18 章 在 本 地 系统 创建 超级 用 户 一 样 提示 你 输入 
相关 的 信息 。 在 这 个 终端 会 话 中 创建 超级 用 户 后 ， 执 行 命令 exit 返回 到 本 地 系统 的 终端 会 话 
( 见 @ )。 

现在 ， 你 可 以 在 在 线 应 用 程序 的 URL 末尾 添加 /admin/ 来 登录 管理 网 站 了 。 对 我 而 言 ， 这 个 
URL 为 https://secret-lowlands-82594.herokuapp.com/admin/。 

如 果 有 其 他 人 使 用 这 个 项 目 ， 别 忘 了 你 能 访问 他 们 的 所 有 数据 ! 千 万 别 不 把 这 一 点 当 回 事 
否则 用 户 就 不 会 再 将 数据 托付 给 你 了 。 

2. 在 Heroku 上 创建 对 用 户 友好 的 URL 


你 很 可 能 希望 URL 更 友好 ， 比 https://secret-lowlands-82594.herokuapp.com/admin/ 更 好 记 。 为 
只 需 使 用 一 个 命令 重 命 名 应 用 程序 : 


中 


此 


(11 env)learning log$ heroku apps:rename learning-log 
Renaming secret-lowlands-82594 to learning-log-2e... done 
https://learning-log.herokuapp.com/ | https://git.heroku.com/learning-log.git 
Git remote heroku updated 

®@ Don't forget to update git remotes for all other local checkouts of the app. 
(11 env)learning log$ 


给 应 用 程序 命名 时 ， 可 使 用 字母 、 数 字 和 连 字 符 ， 并 且 想 怎么 命名 都 可 以 ， 只 要 指定 的 名 称 
未 被 别人 使 用 就 行 。 现 在 ,项 目的 URL 变 成 了 https://learning-log.herokuapp.com/。 使 用 以 前 的 
URL 再 也 无 法 访问 它 ， 命 令 apps :rename 将 整个 项 目 都 移 到 了 新 的 URL 处 。 


注意 ”使 用 Heroku 提供 的 免费 服务 部 署 项 目 时 ,如 果 项 目 在 指定 时 间 内 未 收 到 请 求 或 过 于 活跃 ， 
Heroku 将 让 项 目 进 入 休眠 状态 。 用 户 访问 处 于 休眠 状态 的 网 站 时 ， 加 载 时 间 将 更 长 ， 但 
对 于 后 续 请 求 , 服务 器 的 响应 速度 将 更 快 。 这 就 是 Heroku 能 够 提供 免费 部 署 的 原因 所 在 。 20 
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20.2.12 ”确保 项 目的 安全 


当前 ， 部 署 的 项 目 存 在 严重 的 安全 问题 ，settings.py 包含 设置 DEBUG=True， 指 定 在 发 生 错误 
时 显示 调试 信息 。 开 发 项 目 时 ,Django 的 错误 页 面 显示 了 重要 的 调试 信息 ,如 果 将 项 目 部 署 到 服 
务 器 后 还 保留 这 个 设置 ， 将 给 攻击 者 提供 大 量 可 利用 的 信息 。 

在 在 线 项 目 中 , 我 们 将 设置 一 个 环境 变量 ， 以 控制 是 否 显示 调试 信息 。 环 境 变 量 是 在 特定 环 
境 中 设置 的 值 。 这 是 在 服务 器 上 存储 敏感 信息 并 将 其 与 项 目 代 码 分 开 的 方式 之 一 。 

下 面 来 修改 settings.py， 使 其 在 项 目 于 Heroku 上 运行 时 检查 一 个 环境 变量 : 


settings.py  -- 5/1p-- 
# Heroku 设置 
import django_ heroku 
django heroku. settings(locals()) 


if os.environ.get('DEBUG') == "TRUE': 
DEBUG = True 

elif os.environ.get('DEBUG') == 'FALSE': 
DEBUG = False 


方法 0s .environ.get() 从 项 目 当前 所 处 的 环境 中 读 取 与 特定 环境 变量 相关 联 的 值 。 如 果 设 置 
了 这 个 环境 变量 ,就 返回 它 的 值 ， 如 果 没 有 设置 ， 就 返回 None。 使 用 环境 变量 来 存储 布尔 值 时 ， 
必须 小 心 应 对 ， 因 为 在 大 多 数 情况 下 ， 环 境 变 量 存储 的 都 是 字符 串 。 请 看 下 面 在 简单 的 Python 
终端 会 话 中 执行 的 代码 片段 : 


>>> bool('False') 
True 


字符 串 'False' 对 应 的 布尔 值 为 True， 因 为 非 空 字符 串 对 应 的 布尔 值 都 为 True。 因 此 ， 我 们 
将 使 用 全 大 写 的 字符 串 'TRUE' 和 "FALSE' , 以 明确 地 指出 存储 的 不 是 Python 布尔 值 True 和 False。 
Django 读 取 Heroku 中 键 为 'DEBUG ' 的 环境 变量 时 ,如 果 其 值 为 'TRUE ' ,我 们 就 将 DEBUG 设置 为 True; 
如 果 其 值 为 'FALSE' ， 就 将 DEBUG 设置 为 False。 


20.2.13 ”提交 并 推送 修改 


现在 需要 将 对 settings.py 所 做 的 修改 提交 到 Git 仓库 ， 再 将 修改 推送 到 Heroku。 下 面 的 终端 
会 话 演示 了 这 个 过 程 : 


@ (]1 env)learning log$ git commit -am "Set DEBUG based on environment variables." 
[master 3427244] Set DEBUG based on environment variables. 
1 file changed, 4 insertions(+) 
@ (ll env)learning log$ git status 
On branch master 
nothing to commit, working tree clean 
(1] env)learning log$ 
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我 们 执行 命令 git commit， 并 指定 一 条 简短 而 有 描述 性 的 提交 消息 ( 见 @ )。 别 忘 了 ， 标 志 
-an 让 Git 提交 所 有 修改 过 的 文件 ， 并 记录 一 条 日 志 消息 。Git 找 出 唯一 修改 过 的 文件 ， 并 将 所 做 
的 修改 提交 到 仓库 。 

四 处 显示 的 状态 表明 ， 当 前 位 于 仓库 的 分 支 master, 没有 任何 未 提交 的 修改 。 推 送 到 Heroku 
前 ， 必 须 检 查 状 态 并 看 到 刚才 所 说 的 消息 。 如 果 没 有 看 到 这 样 的 消息 ， 就 说 明 有 未 提交 的 修改 ， 
而 这 些 修 改 将 不 会 推送 到 服务 器 。 在 这 种 情况 下 , 可 答 试 再 次 执行 命令 commit, 但 如 果 你 不 知道 
该 如 何 解 决 这 个 问题 ， 请 阅读 附录 D， 更 深入 地 了 解 Git 的 用 法 。 

下 面 将 修改 后 的 仓库 推送 到 Heroku: 


(11_ env)learning log$ git push heroku master 


remote: Building source: 

remote: 

remote: ----- > Python app detected 

remote: ----- > Installing requirements with pip 
-- Snip-- 

remote: ----- > Launching... 

remote: Released v6 

remote: https://learning-log.herokuapp.com/ deployed to Heroku 
remote: 

remote: Verifying deploy... done. 

To https://git.heroku.com/learning-log.git 


144f020. .d5075a1 master -> master 
(1] env)learning log$ 


Heroku 发 现 仓库 发 生 了 变化 ， 因 此 重建 项 目 ， 确保 所 有 的 修改 都 生效 。 它 不 会 重建 数据 库 ， 
因此 这 次 无 须 执行 命令 migrate。 
20.2.14 在 Heroku 上 设置 环境 变量 

现在 可 通过 Heroku 将 settings.py 中 的 DEBUG 设置 为 所 需 的 值 了 。 


命令 heroku config:set 设置 一 个 环境 变量 : 


(11 env)learning log$ heroku config:set DEBUG=FALSE 
Setting DEBUG and restarting @ learning-log... done, v7 
DEBUG: FALSE 

(11 env)learning log$ 


每 当 你 在 Heroku 上 设置 环境 变量 时 ，Heroku 都 将 重启 项 目 ， 让 环境 变量 生效 。 


要 核实 部 署 现 在 更 安全 了 ， 请 输入 项 目的 URL， 并 在 末尾 加 上 未 定义 的 路 径 ， 如 尝试 访问 
http://learning-log.herokuapp.com/letmein。 你 将 看 到 通用 的 错误 页 面 , 它 没有 泄露 任何 有 关 该 项 目 
的 具体 信息 。 如 果 通 过 输入 URL http://localhost:8000/letmein/ 向 本 地 的 “学 习 笔记 ”发 出 同样 的 
请 求 ， 你 将 看 到 完整 的 Django 错误 页 面 。 这 样 的 结果 非常 理想 : 接着 开发 这 个 项 目 时 ， 你 可 以 20 
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看 到 信息 丰富 的 错误 消息 ， 但 访问 在 线 项 目的 用 户 看 不 到 有 关 代 码 的 重要 信息 。 

如 果 你 在 部 署 应 用 程序 时 遇 到 麻烦 ， 需 要 排除 故障 ， 可 执行 命令 heroku config:set 
DEBUG='TRUE' ， 以 便 访 问 在 线 项 目 时 能 够 看 到 完整 的 错误 报告 。 成 功 地 排除 故障 后 ， 务 必 将 这 个 环 
境 变 量 重 置 为 'FALSE'。 男 外 ， 请 务必 小 心 ， 一 旦 有 用 户 经 常 访问 这 个 在 线 项 目 ， 就 不 要 这 样 做 。 


20.2.15 ”创建 自 定义 错误 页 面 


第 19 章 对 “学 习 笔记 ”进行 了 配置 ,使 其 在 用 户 请 求 不 属于 自己 的 主题 或 条 目 时 返回 404 
错误 。 你 可 能 还 遇 到 过 一 些 500 错误 ( 内 部 错误 )。404 错误 通常 意味 着 Django 代码 是 正确 的 ， 
但 请 求 的 对 象 不 存在 。500 错误 通常 意味 着 代码 有 问题 ， 如 views.py 中 的 函数 有 问题 。 当 前 ,在 
这 两 种 情况 下 ，Django 都 返回 通用 的 错误 页 面 ,但 我 们 可 以 编写 外 观 与 “学 习 笔记 ”一 致 的 404 
和 500 错误 页 面 模板 。 这 些 模板 必须 放 在 根 模板 目录 中 。 


1. 创建 自 定义 模板 


在 最 外 层 的 文件 夹 learning log 中 ， 新 建 一 个 文件 来， 并 将 其 命名 为 ttmplates。 然 后 在 这 个 
文件 夹 中 新 建 一 个 名 为 404.html 的 文件 ( 这 个 文件 的 路 径 应 为 learning log/templates/404.html )， 
并 在 其 中 输入 如 下 内 容 : 


404.him! {% extends "learning logs/base.html" %} 


{% block page_ header %} 
<h2>The item you requested is not available. (404)</h2> 
{% endblock page header %} 


这 个 简单 的 模板 指定 了 通用 的 404 错误 页 面包 含 的 信息 ， 但 该 页 面 的 外 观 与 网 站 其 他 部 分 
一 致 。 


再 创建 一 个 名 为 500.html 的 文件 ， 并 在 其 中 输入 如 下 代码 : 


500.himl {% extends "learning logs/base.html" %} 


{% block page header %} 
<h2>There has been an internal error. (500)</h2> 
{% endblock page header %} 


这 些 新 文件 要 求 对 settings.py 做 细微 的 修改 : 


settings.py -- 5/1p-- 
TEMPLATES = [ 
{ 
'BACKEND': 'django.template.backends.django.DjangoTemplates', 
'DIRS': [os.path.join(BASE DIR, 'templates')], 
'APP_DIRS': True, 
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-- Snip-- 
外 
] 


-- SNip-- 


这 项 修改 让 Django 在 根 模板 目录 中 查找 错误 页 面 模板 。 


2. 在 本 地 查看 错误 页 面 


将 项 目 推送 到 Heroku 前 ， 如 果 要 在 本 地 查看 错误 页 面 是 什么 样 的， 首先 需要 在 本 地 设置 中 
设置 Debug=False， 以 禁止 显示 默认 的 Django 调试 页 面 。 为 此 ， 可 对 settings.py 做 如 下 修改 (请 
确保 修改 的 是 settings.py 中 用 于 本 地 环境 的 部 分 ， 而 不 是 用 于 Heroku 的 部 分 ): 


settings.py -~-- S11p-- 
# 安全 警告 : 不 要 在 在线 环境 中 启用 调试 | 
DEBUG = False 
-- Snip-- 


现在 ,请求 不 属于 你 的 主题 或 条 目 ， 以 查看 404 错误 页 面 。 然 后 请 求 不 存在 的 主题 或 条 目 ， 
以 查看 500 错误 页 面 。 例 如， 如 果 输 入 http://localhost:8000/topics/999/, 将 出现 500 错误 页 面 ， 除 
非 你 输入 的 主题 已 经 超过 了 999 个 ! 


查看 错误 页 面 后 ,将 本 地 DEBUG 的 值 重 新 设置 为 True ,为 后 续 开 发 提供 方便 。( 在 管理 Heroku 
设置 的 部 分 ， 确 保 处 理 DEBUG 的 方式 不 变 。 


注意 500 错误 页 面 不 会 显示 任何 有 关 当前 用 户 的 信息 ， 因 为 发 生 服 务 器 错误 时 ，Django 不 会 
通过 响应 发 送 任何 上 下 文 信息 。 


3. 将 修改 推送 到 Heroku 
现在 需要 提交 对 错误 页 面 所 做 的 修改 ， 并 将 这 些 修改 推送 到 Heroku: 


@ (1]_env)learning_ log$ git add . 
@ (11 env)learning log$ git commit -am "Added custom 404 and 500 error pages." 
3 files changed, 15 insertions(+), 10 deletions(-) 
create mode 100644 templates/404.html 
create mode 100644 templates/500.html 
@ (ll] env)learning log$ git push heroku master 
-- Snip-- 
remote: Verifying deploy.... done. 
To https://git.heroku.com/learning-log.git 
d50753a1..4bd3b1c master -> master 
(1] env)learning log$ 


在 @ 处 ， 执 行 命令 git add .， 因 为 我 们 在 项 目 中 创建 了 一 些 新 文件 ， 需 要 让 Git 跟踪 它们 。 
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然后 ， 提 交 所 做 的 修改 ( 见 @ )， 并 将 修改 后 的 项 目 推送 到 Heroku ( 见 @ )。 


现在 , 错误 页 面 出 现时 ， 其 样式 应 该 与 网 站 其 他 部 分 一 致 。 这 样 ， 在 发 生 错 误 时 ， 用 户 将 不 
会 感到 别扭。 


4. 使 用 方法 get_object_or 404() 


现在 , 如果 用 户 手工 请 求 不 存在 的 主题 或 条 目 , 将 导致 500 错误 。Django 尝试 演 染 不 存在 的 
页 面 ， 但 没有 足够 的 信息 来 完成 这 项 任务 ， 进 而 引发 了 5$00 错误 。 对 于 这 种 情形 ， 将 其 视 为 404 
错误 更 合适 。 为 此 可 使 用 Django 快捷 函数 get_ object_ or 404()。 这 个 函数 尝试 从 数据 库 获取 请 
求 的 对 象 ， 如 果 这 个 对 象 不 存在 ,就 引发 404 异常 。 我 们 在 views.py 中 导入 这 个 函数 ,并 用 它 替 
换 函 数 get() : 


views.py from django.shortcuts import render, redirect, get object or 404 
from django.contrib.auth.decorators import login required 
-- Snip-- 
@login required 
def topic(request, topic id): 
"" "显示 单个 主题 及 其 所 有 的 条 目 。""" 
topic = get object or 404(Topic, id=topic id) 
# 确定 主题 属于 当前 用 户 。 
--517]-- 


现在 ， 如 果 请 求 不 存在 的 主题 ( 如 使 用 URL http://localhost:8000/topics/999/ )， 将 看 到 404 错 
误 页 面 。 为 部 署 这 里 所 做 的 修改 ， 再 次 提交 ， 并 将 项 目 推送 到 Heroku。 


20.2.16 ”继续 开发 


将 项 目 “ 学 习 笔 记 ” 推 送 到 服务 器 后 ， 你 可 能 想 进 一 步 开 发 它 或 开发 要 部 署 的 其 他 项 目 。 更 
新 项 目的 过 程 几 乎 完全 相同 。 


首先 ， 对 本 地 项 目 做 必要 的 修改 。 如 果 在 修改 过 程 中 创建 了 新 文件 ,使 用 命令 git add .( 千 
万 别 忘 记 末尾 的 句点 ) 将 其 加 入 Git 仓库 中 。 如 果 有 修改 要 求 迁移 数据 库 , 也 需要 执行 这 个 命令 ， 
为 每 个 迁移 都 将 生成 新 的 迁移 文件 。 

然后 ， 使 用 命令 git commit -am "commit message" 将 修改 提交 到 仓库 ， 再 使 用 命令 git push 
heroku master 将 修改 推送 到 Heroku。 如 果 在 本 地 迁移 了 数据 库 ， 也 需要 迁移 在 线 数据 库 。 为 此 ， 
可 使 用 一 次 性 命令 heroku run python manage.py migrate， 也 可 使 用 heroku run bash 打开 远程 
终端 会 话 ， 并 在 其 中 执行 命令 python manage.py migrate。 然 后 访问 在 线 项 目 ， 确 认 期 望 看 到 的 
修改 已 生效 。 

在 这 个 过 程 中 很 容易 犯错 ,因此 看 到 错误 时 不 要 大 惊 小 怪 。 如 果 代 码 不 能 正确 地 工作 ， 请 重 
新 审视 所 做 的 工作 ,尝试 找 出 其 中 的 错误 。 如 果 找 不 出 错误 , 或 者 不 知道 如 何 撤销 错误 ,请 参阅 
附录 C 中 有 关 如 何 寻 求 帮助 的 建议 。 不 要 着 于 去 寻求 帮助 : 每 个 学 习 开发 项 目的 人 都 可 能 遇 到 过 
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你 面临 的 问题 ， 因 此 总 有 人 乐意 伸 出 援手 。 通 过 解决 遇 到 的 每 个 问题 ， 可 让 你 的 技能 稳步 提高 ， 
最 终 能 够 开发 可 靠 而 有 意义 的 项 目 ， 还 能 解决 别人 遇 到 的 问题 。 


20.2.17 设置 SECRET_KEY 


Django 根据 settings.py 中 设置 SECRET_KEY 的 值 来 实现 大 量 的 安全 协议 。 在 这 个 项 目 中 , 提交 
到 仓库 的 设置 文件 包含 设置 SECRET_KEY。 对 于 一 个 练习 项 目 而 言 ， 这 足够 了 ， 但 对 于 生产 网 站 ， 
应 更 细致 地 处 理 设置 SECRET_KEY。 如果 你 创建 的 项 目的 用 途 很 重要 , 务必 研究 如 何 更 安全 地 处 理 
设置 SECRET KEY。 


20.2.18 ”将 项 目 从 Heroku 删除 


一 个 不 错 的 练习 是 , 使 用 同一 个 项 目 或 一 系列 小 项 目 执行 部 署 过 程 多 次 , 直到 对 部 署 过 程 了 
如 指 掌 。 然 而 ， 你 需要 知道 如 何 删除 部 署 的 项 目 。Heroku 限制 了 可 免费 托管 的 项 目 数 ， 而 你 也 
不 希望 自己 的 账户 中 包含 大 量 练习 项 目 。 

在 Heroku 网 站 登录 后 ， 将 重 定向 到 一 个 页 面 ， 其 中 列 出 了 你 托管 的 所 有 项 目 。 单 击 要 删除 
的 项 目 ， 你 将 看 到 另 一 个 页 面 ， 其 中 显示 了 有 关 这 个 项 目的 信息 。 单 击 链接 Settings， 再 向 下 滚 
动 ， 找 到 用 于 删除 项 目的 链接 并 单 击 它 。 这 种 操作 是 不 可 撤销 的 ， 因 此 Heroku 让 你 手工 输入 要 
删除 的 项 目的 名 称 ， 确 认 你 确实 要 删除 它 。 


如 果 喜 欢 在 终端 中 工作 ， 也 可 使 用 命令 destroy 来 删除 项 目 : 


(11 env)learning log$ heroku apps:destroy --app appname 


appname 是 要 删除 的 项 目的 名 称 , 可 能 类 似 于 secret-lowlands-82594, 也 可 能 类 似 于 learning-log 
( 如 果 你 重 命 名 了 项 目 )。 你 将 被 要 求 再 次 输入 项 目 名 ,确认 你 确实 要 删除 它 。 


注意 ”删除 Heroku 上 的 项 目 对 本 地 项 目 没有 任何 影响 。 如 果 没 有 人 使 用 你 部 署 的 项 目 , 就 尽管 
去 练习 部 署 过 程 好 了 ， 在 Heroku 上 删除 项 目 再 重新 部 署 完全 合情合理 。 


动手 试 一 斌 
练习 20-3: 在 线 博客 将 你 一 直 在 开发 的 项 目 Blog 部 署 到 Heroku。 确 保 将 DEBUG 
设置 为 False， 以 免 出 现 错误 时 用 户 看 到 完整 的 Django 错误 页 面 。 


练习 20-4: 在 更 多 的 情况 下 显示 404 错误 页 面 在 视图 函数 new entry() 和 edit 
entry() 中 ， 也 使 用 函数 get object or 404()。 完 成 这 些 修 改 后 进行 测试 : 输入 类 似 于 
http://localhost:8000/new_entry/999/ 的 URL， 确 认 看 到 的 是 404 错误 页 面 。 
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练习 20-5: 扩展 “学 习 笔记 ” 在 “学 习 笔 记 ” 中 添加 一 项 功能 ， 并 将 修改 推送 到 
在 线 部 署 。 尝试 做 一 项 简单 的 修改 ， 如 在 主页 中 对 项 目 做 更 详细 的 描述 。 再 尝试 添加 一 
项 更 高 级 的 功能 ， 如 让 用 户 能 够 将 主题 设置 为 公开 的 。 为 此 ， 需 要 在 模型 Topic 中 添加 一 


个 名 为 public 的 属性 (其 默认 值 为 False )， 并 在 new topic 页 面 中 添加 一 个 表单 元 素 ， 
让 用 户 能 够 将 私有 主题 改 为 公开 。 然 后 ， 需 要 迁移 项 目 ， 并 修改 views.py， 让 未 登录 的 
用 户 也 可 以 看 到 所 有 公开 的 主题 。 将 修改 推送 到 Heroku 后 ， 别 忘 了 迁移 在 线 数据 库 。 


20.3 小 结 


在 本 章 中 ,你 学 习 了 如 何 使 用 Bootstrap 库 和 应 用 程序 django-bootstrap4 赋予 应 用 程序 简单 而 
专业 的 外 观 。 使 用 Bootstrap 意味 着 无 论 用 户 使 用 哪 种 设备 来 访问 你 的 项 目 ， 你 选择 的 样式 都 将 
实现 几乎 相同 的 效果 。 


你 学 习 了 Bootstrap 的 模板 ， 并 使 用 模板 Navbar static 赋予 了 “学 习 笔 记 ” 简 单 的 外 观 。 你 学 
习 了 如 何 使 用 jumbotron 来 突出 主页 中 的 消息 ,还 学 习 了 如 何 给 网 站 的 所 有 页 面 设置 一 致 的 样式 。 


在 本 章 最 后 一 他， 你 学 习 了 如 何 将 项 目 部 署 到 Heroku 服务 器 ， 让 任何 人 都 能 够 访问 。 你 创 
建 了 一 个 Heroku 账户 ， 并 安装 了 一 些 帮 助 管理 部 署 过 程 的 工具 。 你 使 用 Git 将 能 够 正确 运行 的 
项 目 提交 到 仓库 ， 再 将 这 个 仓库 推送 到 Heroku 的 服务 嚣 。 最 后 ,你 将 DEBUG 设置 为 False， 以 确 
保 在 线 应 用 程序 的 安全 。 


开发 完 项 目 “ 学 习 笔 记 ” 后 ， 你 就 能 自己 动手 开发 项 目 了 。 请 先 让 项 目 尽 可 能 简单 ， 确 定 它 
能 正确 运行 后 ， 再 添加 复杂 的 功能 。 愿 你 学 习 愉快 ， 开 发 项 目 时 有 好 运 相伴 ! 


安装 与 故障 排除 


Python 有 不 同 的 版 本 ， 在 各 种 操作 系统 中 有 很 多 安装 方式 。 如 
果 第 1 章 介 绍 的 方式 不 管用 , 或 者 要 安装 非 系统 自 带 的 Python 版 本 ， 
本 附录 可 提供 帮助 。 


A.1 Windows 系统 


A 


第 1 章 的 安装 说 明 指出 了 如 何 使 用 Python 网 站 提供 的 官方 安装 程序 安装 Python。 如 果 执行 
安装 程序 后 ， 无 法 运行 Python， 本 节 的 故障 排除 说 明 将 帮助 你 让 Python 恢复 正常 。 


A.1.1 查找 Python 解释 器 


如 果 执 行 简单 命令 python 时 出 现 错误 消息 , 如 python 不 是 可 识别 的 内 部 或 外 部 命令 ( python 
is not recognized as an internal or external command )， 很 可 能 是 因为 执行 安装 程序 时 没有 选中 复 选 
框 Add Python to PATH。 在 这 种 情况 下 ， 需 要 告诉 Windows 去 哪里 查找 Python 解释 器 。 要 确定 
Python 解释 器 的 位 置 , 请 打开 C 盘 , 并 在 其 中 查找 名 称 以 Python 打头 的 文件 夹 。( 要 找到 这 样 的 
文件 夹 ， 可 能 需要 在 Windows 资源 管理 器 的 搜索 栏 中 输入 单词 python， 因 为 它 可 能 不 在 C 盘 的 
根 目录 下 。) 打开 这 个 文件 来， 并 查找 名 称 为 python ( 全 部 小 写 ) 的 文件 。 右 击 这 个 文件 并 选择 
“属性 ”， 你 将 在 “位 置 ” 后 面 看 到 它 的 路 径 。 


要 告诉 Windows 去 哪里 查找 解释 器 ， 可 以 打开 一 个 终端 窗口 ， 输 入 刚才 看 到 的 路 径 ， 再 输 
人 -version， 并 按 回 车 键 : 


$ C:\Python37\python --version 
Python 3.7.2 
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在 你 的 系统 中 , 这 条 路 径 可 能 类 似 于 下 面 这 样 : C:\Users\username\Programs\Python37\python。 
指定 路 径 后 ，Windows 应 该 会 运行 Python 解释 需 。 


A.1.2 将 Python 添加 到 环境 变量 Path 


如 果 每 次 启动 Python 终端 会 话 时 都 需要 输入 完整 的 路 径 ， 那 就 太 讨 大 了。 因此 ， 我 们 将 在 
系统 中 添加 这 个 路 径 ， 让 你 只 需 使 用 命令 python 即 可 。 打 开 控 制 面板 并 单 击 “ 系 统 和 安全 ”， 再 
单 击 “ 系 统 ”。 单 击 “ 高 级 系统 设置 "， 在 打开 的 窗口 中 单 击 按钮 “环境 变量 ”。 

在 “系统 变量 ”部 分 ， 找 到 并 单 击 变量 Path， 再 单 击 按钮 “编辑 "”。 你 将 看 到 一 系列 位 置 ， 
而 系统 将 在 这 些 位 置 查找 程序 。 单 击 “ 新 建 ”按钮 ， 并 将 文件 python.exe 的 路 径 粘 贴 到 出 现 的 文 
本 框 中 。 如 果 你 的 系统 设置 与 我 的 一 样 ， 这 条 路 径 应 该 是 这 样 的 : 


C:\Python37 


请 注意 ， 这 里 没有 指定 文件 名 python.exe， 而 只 是 告诉 系统 到 哪里 去 查找 它 。 

关闭 终端 窗口 ， 再 打开 一 个 新 的 终端 窗口 。 这 将 在 终端 会 话 中 加 载 变量 Path 的 新 值 。 现 在 
执行 命令 python --version 时 ， 你 将 看 到 刚才 在 变量 Path 中 设置 的 Python 版 本 。 现 在 ， 只 需 在 
命令 提示 符 下 输入 python 并 按 回 车 ， 就 可 启动 Python 终端 会 话 了 。 


注意 ”如果 你 使 用 的 是 较 早 的 Windows 版 本 ， 则 单 击 “ 编 辑 ” 按 钮 时 ， 出 现 的 对 话 框 可 能 包含 
文本 框 “变量 "”。 如 果 是 这 样 ， 请 使 用 右 箭头 键 滚 动 到 最 右边 。 千 万 不 要 履 盖 变量 原来 的 
值 。 如 果 不 小 心 覆 盖 了 ， 请 单 击 “ 取 消 ”按钮 ， 再 重复 前 面 的 步骤 。 在 变量 值 的 末尾 添 
加 一 个 分 号 ， 再 添加 文件 python.exe 的 路 径 ， 如 下 所 示 : 


%SystemRoot%\system32\...\System32\WindowsPowerShell\v1.0\;C:\Python37 


A.1.3 重 装 Python 


如 果 还 是 无 法 运行 Python ， 印 载 Python 并 再 次 执行 安装 程序 通常 能 解决 所 有 的 问题 。 为 此 ， 
打开 “控制 面板 ”并 单 击 “ 程 序 和 功能 ”， 再 向 下 滚动 ， 找 到 并 选择 刚才 安装 的 Python 版 本 。 单 
击 “ 利 载 / 更 改 ”， 在 出 现 的 对 话 框 中 单 击 “ 钊 载 ”。 然 后 ， 按 第 1 章 的 说 明 再 次 执行 安装 程序 ， 
并 确保 选择 了 复 选 框 Add Python to PATH 以 及 其 他 与 系统 相关 的 设置 .如 果 还 是 无 法 运行 Python ， 
又 不 知道 到 哪里 去 寻求 帮助 ， 请 参阅 附录 C 的 建议 。 


A.2 macOsS 系统 
第 1 章 的 安装 说 明 让 你 使 用 Python 网 站 提供 的 安装 程序 ， 我 推荐 你 这 样 做 ， 除 非 有 特殊 原 
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因 。 另 一 种 方法 是 使 用 Homebrew， 在 macOS 系统 中 ,可 使 用 这 个 工具 来 安装 各 种 软件 。 如 果 4 
使 用 过 Homebrew 并 想 使 用 它 来 安装 Python ， 或 者 有 同事 在 使 用 Homebrew 而 你 也 想 安 装 它 , 详 
参阅 接 下 来 的 说 明 。 


KH 今 


ol 


A.2.1 安装 Homebrew 


Homebrew 依赖 于 Apple Xcode 包 中 的 一 些 命令 行 工 具 ， 因 此 你 需要 先 安装 Xcode 命令 行 工 
具 。 为 此 ， 打 开 一 个 终端 窗口 并 执行 如 下 命令 : 


$ xcode-select --install 


在 不 断 出 现 的 确认 对 话 框 中 都 单 击 OK 按钮 。( 根据 网 络 连接 的 速度 ,这 可 能 持续 一 段 时 间 。) 
接 下 来 执行 如 下 命令 以 安装 Homebrew: 


$ /usr/bin/ruby -e "$(curl -fsSL 
https://raw.githubusercontent .com/Homebrew/install/master/install)" 


这 个 命令 可 在 Homebrew 网 站 找到 。 务 必 在 curl -fsSL 和 URL 之 间 包 含 一 个 空格 。 


注意 ”这 个 命令 中 的 -e 让 Ruby (Homebrew 就 是 使 用 这 种 编程 语言 编写 的 ) 执行 下 载 的 代码 。 
除非 来 源 是 你 信任 的 ， 否 则 不 要 运行 这 样 的 命令 。 


为 确认 正确 地 安装 了 Homebrew， 请 执行 如 下 命令 : 


$ brew doctor 
Your System is ready to brew. 


上 述 输 出 表明 ， 可 以 使 用 Homebrew 在 系统 中 安装 包 了 。 


A.2.2 安装 Python 


为 安装 最 新 的 Python 版 本 ， 请 执行 如 下 命令 : 


$ brew install python 


使 用 下 面 的 命令 检查 安装 的 是 哪个 版 本 : 


$ python3 --version 
Python 3.7.2 
$ 


现在 ,可 以 使 用 命令 python3 来 启动 Python 终端 会 话 了 ,还 可 以 使 用 命令 python3 来 配置 文 
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本 编辑 器 ， 使 其 使 用 刚 安装 的 Python 版 本 ( 而 不 是 系统 自 带 的 版 本 ) 来 运行 Python 程序 。 如 果 
不 知道 如 何 配置 Sublime Text 来 使 用 刚 安装 的 Python 版 本 ， 请 参阅 第 1 章 的 说 明 。 


A.3 Linux 系统 


几乎 所 有 Linux 系统 都 默认 安装 了 Python ， 但 如 果 自 带 的 版 本 低 于 Python 3.6， 就 需要 安装 
最 新 的 版 本 。 下 面 的 说 明 适 用 于 大 多 数 基于 apt 的 系统 。 


你 将 使 用 名 为 deadsnakes 的 包 ， 它 能 让 你 轻松 地 安装 多 个 Python 版 本 。 请 执行 如 下 命令 : 


$ sudo add-apt-repository ppa:deadsnakes/ppa 
$ sudo apt-get update 
$ sudo apt install python3.7 


这 些 命 令 将 在 你 的 系统 中 安装 Python 3.7。 


执行 下 面 的 命令 启动 一 个 运行 Python 3.7 的 终端 会 话 : 


python3.7 
>>> 


配置 文本 编辑 器 使 其 使 用 Python 3.7 以 及 从 终端 运行 程序 时 ， 也 需要 用 到 这 个 命令 。 


A.4 Python 关键 字 和 内 置 函 数 


Python 包含 一 系列 关键 字 和 内 置 函 数 ， 给 变量 命名 时 ， 知 道 这 些 关 键 字 和 内 置 函 数 很 重要 : 
不 能 将 Python 关键 字 用 作 变 量 名 ， 也 不 应 将 Python 内 置 函 数 的 名 称 用 作 变 量 名 ， 否 则 将 覆盖 相 
应 的 内 置 函 数 。 


本 市 将 列 出 Python 关键 字 和 内 置 函数 的 名 称 ， 让 你 知道 应 避免 使 用 哪些 变量 名 。 


A.4.1 ”Python 关键 字 
下 面 的 关键 字 都 有 特殊 含义 ， 如 果 将 它们 用 作 变 量 名 ， 将 引发 错误 : 


False await else import pass 
None break except in raise 
True class finally is return 
and continue for lambda try 
as def from nonlocal while 
assert del global not with 


async elif if Or yield 
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A.4.2 ”Python 内置 函数 


将 内 置 函 数 名 用 作 变 量 名 时 ， 不 会 导致 错误 ,但 将 覆盖 这 些 函 数 的 行为 : 


abs() 

all() 

any() 
ascii() 
bin() 

bool() 
breakpoint() 
bytearray() 
bytes() 
callable() 
chr() 
classmethod() 
compile() 
complex() 


delattr() 
dict() 
dir() 
divmod() 


enumerate() 


eval 
exec 


) 
) 


filter() 


floa 


t() 


format() 


frozenset() 


geta 


ttr() 


globals() 


hasa 


ttr() 


hash() 
help() 

hex() 

id() 

input() 
int() 
isinstance() 
issubclass() 
iter() 

len() 

list() 
locals() 
map() 

max() 


memoryview() 
min() 

next() 
object() 
oct() 
open() 
ord() 
pow() 
print() 
property() 
range() 
repr() 
reversed() 
round() 


set() 
setattr() 
slice() 
sorted() 
staticmethod() 
str() 

sum() 
super() 
tuple() 
type() 
vars() 

zip() 

_ import () 


文本 编辑 器 与 IDE 


程序 员 要 花费 大 量 时 间 编 写 、 阅 读 和 编辑 代码 ,因此 必须 使 用 文 
本 编辑 器 或 集成 开发 环境 (IDE ) 来 尽 可 能 提高 效率 。 好 的 编辑 器 会 
做 些 简单 的 工作 ， 如 突出 代码 结构 ， 帮 助 你 在 编程 期 间 发 现 常见 的 
bug， 但 是 又 不 会 做 得 太 多 ， 以 免 打 断 你 的 思路 。 编 辑 器 还 提供 了 一 
些 很 有 用 的 功能 ， 如 自动 缩 进 、 标 识 出 合适 的 行 长 以 及 提供 常用 操作 
的 快捷 键 。 


IDE 是 一 种 提供 了 大 量 其 他 工具 ( 如 交互 式 调 试 器 和 代码 检视 器 ) 的 文本 编辑 器 。IDE 在 你 
输入 代码 时 对 其 进行 检查 ， 力 图 弄 清 你 创建 的 项 目 是 什么 样 的 。 例 如 ， 当 你 输入 函数 名 时 ，IDE 
可 能 显示 该 函数 接受 的 所 有 参数 。 在 一 切 顺利 且 你 明白 显示 的 内 容 时 , 这 可 能 很 有 帮助 。 不 过 对 
初学 者 来 说 ， 这 可 能 是 极 大 的 负担 ， 因 为 他 们 可 能 不 明白 为 何在 IDE 中 输入 的 代码 不 可 行 。 

我 建议 你 在 学 习 编 程 期 间 使 用 简单 的 文本 编辑 器 。 文 本 编辑 器 给 系统 带 来 的 负担 轻 得 多 ， 
因此 如 果 你 使 用 的 计算 机 较 旧 或 配置 的 资源 有 限 ， 文 本 编辑 器 运行 起 来 将 比 IDE 顺畅 得 多 。 如 果 
你 熟悉 IDE 或 者 周围 有 人 在 使 用 IDE 而 你 也 想 在 这 样 的 环境 中 编程 ， 则 完全 可 以 尝试 使 用 IDE。 

就 目前 而 言 ， 不 用 太 操心 工具 选择 的 问题 ， 还 不 如 将 时 间 花 在 深入 了 解 Python 语言 和 开发 
感 兴趣 的 项 目 上 。 掌 握 基础 知识 后 ， 就 会 更 清楚 什么 样 的 工具 适合 你 。 

本 附录 介绍 如 何 配置 文本 编辑 器 Sublime Text， 以 提高 工作 效率 。 最 后 还 将 简单 介绍 众多 其 
他 编辑 器 ,你 可 能 会 考虑 使 用 它们 或 者 看 到 其 他 Python 程序 员 使 用 它们 。 


B.1 自 定义 Sublime Text 设置 


在 第 1 章 ， 你 配置 了 Sublime Text， 使 其 使 用 所 需 的 Python 版 本 来 运行 程序 。 下 面 来 配置 其 
他 方面 ， 让 Sublime Text 完成 本 附录 开头 提 到 的 一 些 工 作 。 
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B.1.1 将 制 表 符 转 换 为 空 

如 果 在 代码 中 混用 制 表 符 和 空格 键 , 可 能 导致 程序 出 现 难以 调试 的 问题 。 为 避免 这 种 情况 发 
生 ， 可 配置 Sublime Text， 使 其 总 是 使 用 空格 来 缩 进 ， 即 便 你 按 下 Tab 键 亦 如 此 。 为 此 ， 打 开 菜 
单 View* mdentation， 核 实 选择 了 Indent Using Spaces。 如 果 没 有 ， 现 在 选择 就 它 ， 并 确保 将 Tab 
Width 设置 为 4 个 空格 。 

如 果 你 已 经 在 程序 中 混用 了 制 表 符 和 空格 , 可 将 所 有 制 表 符 都 转换 为 空格 , 方法 是 选择 荣 
Viewr? Indentation > Convert Tabs to Spaces。 也 可 通过 单 击 Sublime Text 窗口 右 下 角 的 Spaces 字样 
来 访问 这 些 设置 。 


现在 如 果 按 Tab 键 来 缩 进 代码 行 ，Sublime Text 将 自动 将 制 表 符 转换 为 指定 数量 的 空格 。 


B.1.2 设置 行 长 标志 

大 多 数 编辑 器 允许 你 设置 视觉 线索 (通常 是 竖 线 )， 指 出 代码 行 应 在 哪里 结束 。 在 Python 社 
区 ， 这 方面 的 约定 是 行 长 不 要 超过 79 字符 。 要 设置 这 种 标志 ， 可 打开 菜单 View* Ruler， 再 选择 
80。Sublime Text 将 在 第 80 字符 标志 处 放置 一 条 竖 线 ， 帮 助 确保 代码 行 的 长 度 是 合适 的 。 


B.1.3 缩 进 和 取消 缩 进 代 码 块 
要 缩 进 代 码 块 ， 可 选择 它 ， 再 选择 菜单 Edit w Line * Indent 或 按 Ctrl + ] ( macOS 系统 中 为 


Command+] )。 要 取消 缩 进 代码 块 ， 可 选择 菜单 Edit Line > Unindent 或 按 Ctrl+[ (macOS 系统 
中 为 Command + [ )。 


B.1.4 将 代码 块 注释 掉 


要 暂时 禁用 代码 块 ,可 选中 它 并 注释 掉 , 从 而 让 Python 忽略 它 。 通 过 选择 菜单 Edit Comment 
> Toggle Comment 或 按 Ctrl + / (macOS 系统 中 为 Command + /)， 可 将 选 定 的 代码 行 注释 掉 : 在 
行 首 添加 井 号 (# )， 并 保持 缩 进程 度 不 变 ， 以 指出 这 不 是 常规 注释 。 要 对 代码 块 取消 注释 ， 可 选 
中 它 ， 并 再 次 选择 前 述 菜单 项 。 


B.1.5 保存 配置 


前 面 提 到 的 一 些 设置 只 影响 当前 文件 ， 要 让 设置 影响 所 有 在 Sublime Text 中 打开 的 文件 ， 需 
要 定义 用 户 设置 。 为 此 选择 菜单 Preferences > Settings， 找 到 文件 Preferences.sublime-settings 一 
User， 并 在 其 中 输入 如 下 内 容 : 


{ 
"rulers": [80], 
"translate tabs to spaces": true 


} 
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保存 这 个 文件 ， 则 指定 的 标尺 和 制 表 符 设置 将 被 应 用 于 在 Sublime Text 中 打开 的 所 有 文件 。 
在 这 个 文件 中 添加 设置 时 ， 确 保 每 行 都 以 逗号 结尾 , 但 最 后 一 行 例外 。 你 可 以 在 网 上 查看 其 他 用 
户 的 设置 文件 ， 进 而 自 定 义 编辑 器 ， 以 最 大 限度 地 提高 工作 效率 。 


B.1.6 ”进一步 自 定义 


你 能 以 众多 方式 自 定义 Sublime Text， 进 一 步 提高 工作 效率 。 探 索 菜单 时 ， 要 留意 最 常用 的 
菜单 项 的 键盘 快捷 键 。 通 过 使 用 键盘 快捷 键 而 不 是 鼠标 或 触摸 板 来 执行 操作 ， 可 提高 效率 。 不 要 
试图 一 次 性 记 住 所 有 的 快捷 键 , 只 需 记 住 最 常 执行 的 操作 的 快捷 键 就 行 , 同时 看 看 有 没有 其 他 功 
能 可 帮助 你 改善 工作 流程 。 


B.2 其 他 文本 编辑 器 和 IDE 


你 肯定 会 听 说 众多 其 他 的 文本 编辑 器 ,或 者 看 到 有 人 使 用 这 些 编辑 器 。 对 于 这 些 编辑 顺 , 通 
常 可 像 自 定义 Sublime Text 那 样 进行 配置 。 下 面 介 绍 你 可 能 听 人 说 到 的 一 些 文本 编辑 器 。 


B.2.1 IDLE 


IDLE 是 Python 自 带 的 文本 编辑 器 。 相 比 于 Sublime Text， 它 不 那么 直观 ,但 有 些 初学 者 教 
程 可 能 会 提 到 它 ， 因 此 你 可 能 想 试 一 试 。 


B.2.2 Geany 

Geany 是 一 款 简 单 的 编辑 器 ， 你 可 在 其 中 直接 运行 所 有 的 程序 。 它 在 终端 窗口 中 显示 所 有 输 
出 ， 有 助 于 你 逐渐 习惯 使 用 终端 。Geany 的 界面 非常 简单 ， 但 功能 强大 ， 因 此 很 多 经 验 丰富 的 程 
序 员 也 在 使 用 它 。 


B.2.3 Emacs 和 Vim 


Emacs 和 Vim 是 两 款 流行 的 编辑 器 ,， 深 受众 多 经 验 丰富 的 程序 员 喜 爱 ， 因 为 使 用 它们 时 , 用 
户 的 手 根本 不 用 离开 键盘 。 因 此 学 会 使 用 这 些 编辑 器 后 ， 编 写 、 阅 读 和 编辑 代码 的 效率 将 获得 极 
大 提高 。 不 过 这 也 意味 着 学 会 使 用 它们 的 难度 极 大 。 大 多 数 Linux 和 macOS 计算 机 自 带 Vim， 
而 且 Emacs 和 Vim 都 可 完全 在 终端 中 运行 ， 因 此 它们 常 被 用 来 通过 远程 终端 会 话 在 服务 器 上 编 
写 代码 。 
程序 员 通 常会 推荐 你 试 一 试 它们 ， 但 很 多 编程 老手 忘 了 编程 新 手 要 学 习 的 东西 实在 太 多 了 。 
知道 这 些 编辑 器 是 有 益 的 ,但 请 先 使 用 简单 编辑 器 ， 以 便 专 注 于 学 习 编 程 ， 而 不 是 费时 间 去 学 习 
如 何 使 用 编辑 器 。 等 你 能 够 熟悉 地 编写 和 编辑 代码 后 ， 再 去 使 用 这 些 编辑 器 吧 。 
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B.2.4 _ Atom 
Atom 是 一 款 文本 编辑 器 ， 但 提供 了 一 些 通常 只 有 IDE 才 提 供 的 功能 。 在 Atom 中 ， 可 以 打 
开 单 个 文件 , 也 可 打开 项 目 文件 夹 并 轻松 地 访问 项 目 中 所 有 的 文件 。Atom 集成 了 Git 和 GitHub， 
在 需要 使 用 版 本 控制 时 , 这 让 你 在 编辑 器 中 就 能 使 用 本 地 仓库 和 远程 仓库 , 无 须 切 换 到 另 一 个 终 
端 窗口 。 
Atom 还 允许 你 安装 包 ， 从 而 以 众多 方式 扩展 其 功能 。 可 安装 的 包 有 很 多 ， 这 让 Atom 更 像 
一 个 IDE。 


B.2.5 Visual Studio Code 


Visual Studio Code ( VS Code ) 也 是 一 款 类 似 于 IDE 的 编辑 器 ， 让 你 能 够 高 效 地 使 用 调试 器 ， 
还 集成 了 版 本 控制 功能 并 提供 了 代码 补 全 工具 。 


B.2.6 PyCharm 


PyCharm 是 一 款 深 受 Python 程序 员 欢迎 的 IDE, 因 为 它 是 专门 为 使 用 Python 编程 而 开发 的 。 
完整 版 需要 付费 订阅 ， 但 很 多 开发 人 员 觉 得 免费 的 社区 版 (PyCharm Community Edition ) 也 很 
有 用 。 

PyCharm 提供 了 一 个 linter， 它 检查 编码 是 否 遵循 了 普遍 接受 的 Python 编程 约定 ， 并 在 代码 
不 符合 Python 代码 格式 设置 时 提出 修改 建议 。 它 集成 了 调试 器 ， 旨 在 帮助 你 高 效 消除 错误 ， 还 
支持 各 种 模式 ， 让 你 能 够 高 效 地 使 用 众多 流行 的 Python 库 。 


B.2.7 Jupyter Notebook 


Jupyter Notebook 不 属于 传统 的 文本 编辑 器 或 IDE, 而 是 一 款 主要 由 块 组 成 的 Web 应 用 程序 。 
每 个 块 都 要 么 是 代码 块 ， 要 么 是 文本 块 ， 其 中 的 文本 块 采用 Markdown 格式 ， 让 你 能 够 设置 简单 
的 文本 格式 。 


最 初 开发 时 ，Jupyter Notebook 旨 在 支持 在 科学 应 用 程序 中 使 用 Python， 但 经 过 不 断 的 扩展 
后 ， 它 在 很 多 情形 下 都 很 有 用 。 在 Jupyter Notebook 中 , 不 仅 可 在 .py 文件 中 添加 注释 ， 还 可 编写 
带 简单 格式 的 文本 ， 如 标题 、 带 项 目 符号 的 列表 和 在 不 同 代 码 片段 之 间 导 航 的 超 链接 。 每 个 代码 
块 都 可 独立 运行 , 让 你 能 够 测试 程序 的 一 小 部 分 或 同时 运行 所 有 的 代码 块 。 每 个 代码 块 都 有 独立 
的 输出 区 域 ， 可 根据 需要 显示 或 隐藏 。 

Jupyter Notebook 不 同 单元 格 〈cell ) 之 间 的 交互 有 时 可 能 会 令 你 迷惑 。 例 如 ， 如 果 在 一 个 单 
元 格 中 定义 了 一 个 函数 ,在 其 他 单元 格 中 也 可 使 用 .这 在 大 多 数 情况 下 是 有 益 的 ,但 如 果 Notebook 
很 长 ， 而 你 又 对 Notebook 环境 的 工作 原理 没有 全 面 的 认识 ， 就 会 感到 迷惑 。 


如 果 你 使 用 Python 进行 科学 编程 或 以 数据 为 核心 的 编程 ， 肯 定 会 遇 到 Jupyter Notebook。 


寻求 帮助 


每 个 人 学 习 编程 时 都 会 遇 到 困难 ,因此 作为 程序 员 ,， 需要 学 习 的 
最 重要 的 技能 之 一 就 是 如 何 高 效 地 摆脱 困境 .本 附录 简要 介绍 几 种 帮 
助 你 摆脱 编程 困境 的 方法 。 


陷入 困境 后 ， 首 先 需要 判断 形势 。 向 别人 寻求 帮助 前 ,请 回答 如 下 三 个 问题 。 


口 你 想 要 做 什么 ? 
口 你 已 尝试 哪些 方式 ? 
口 结果 如 何 ? 

答案 应 尽 可 能 具体 。 对 于 第 一 个 问题 ， 像 “我 要 在 Windows 10 笔记 本 计算 机 上 安装 最 新 版 
Python” 这 样 明确 的 陈述 足够 详细 ， 让 Python 社区 的 其 他 人 员 能 够 施 以 援手 ;而 像 “ 我 要 安装 
Python” 这 样 的 陈述 则 没有 提供 足够 的 信息 ， 让 别人 无 法 提供 太 多 帮助 。 

对 于 第 二 个 问题 ， 答 案 应 提供 足够 多 的 细节 ， 这 样 别人 就 不 会 建议 你 去 重复 尝试 过 的 方式 : 
相 比 于 “我 访问 Python 网 站 ， 并 下 载 了 一 些 东 西 ",“ 我 访问 Python 官方 网 站 的 下 载 页 面 ， 单 击 
针对 我 所 使 用 系统 的 Download 按钮 ， 再 运行 安装 程序 ”提供 的 信息 更 详细 。 


对 于 第 三 个 问题 , 知道 准确 的 错误 消息 很 有 用 , 因为 这 样 可 在 线 搜索 错误 消息 以 寻找 解决 方 
案 ， 也 可 在 向 别人 寻求 帮助 时 提供 错误 消息 。 

有 时 候 ， 只 需要 回答 这 三 个 问题 ， 你 就 能 发 现 遗 漏 了 什么 ,无 须 求助 就 能 摆脱 困境 。 程 序 员 
甚至 给 这 种 情形 取 了 一 个 名 字 : 橡皮 有 鸭 子 调 试 法 。 如 果 向 一 只 橡皮 鸭子 〈 或 任何 无 生命 的 东西 ) 
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清楚 地 阐述 自己 的 处 境 , 并 提出 具体 的 问题 , 常常 能 够 回答 这 个 问题 。 有 些 编程 公司 甚至 会 在 办 
公 室 放置 一 个 橡皮 鸭子 ， 旨 在 鼓励 程序 员 “ 与 这 只 鸭子 交流 ”。 


C.1.1 再 试 试 

只 需 回 过 头 去 重新 来 一 次 ,就 足以 解决 很 多 问题 。 假 设 你 在 模仿 本 书 的 一 个 示例 编写 for 循 
环 时 ， 可 能 遗漏 了 某 种 简单 的 东西 ， 如 for 语句 末尾 的 冒号 。 再 试 一 次 可 能 就 会 帮助 你 避免 重复 
同样 的 错误 。 


C.1.2 ” 歇 一 会 儿 


如 果 你 很 长 时 间 内 一 直 在 试图 解决 同一 个 问题 , 那么 休息 一 会 儿 实际 上 是 你 可 采取 的 最 佳 战 
术 。 长 时 间 从 事 一 个 任务 时 ， 你 可 能 变 得 一 根 筋 ， 脑 子 里 想 的 都 是 一 个 解决 方案 。 你 往往 会 对 所 
做 的 假设 视而不见 ， 而 休息 一 会 儿 有 助 于 你 从 不 同 的 角度 看 问题 。 不 用 休息 很 长 时 间 ， 只 要 能 够 
摆脱 当前 的 思维 方式 就 行 。 如 果 你 坐 了 很 长 时 间 , 就 起 来 做 做 运动 : 散 散步 或 者 去 室外 待 一 会 儿 ， 
也 可 以 喝 杯 水 ， 或 者 吃 点 清淡 而 健康 的 零食 。 

如 果 你 心情 诅 形 , 也许 该 将 工作 放 到 一 边 ， 整 天 都 不 再 考虑 。 晚 上 睡 个 好 觉 后 ， 你 常常 会 发 
现 问题 并 不 是 那么 难以 解决 。 


C.1.3 ”参考 本 书 的 在 线 资源 

本 书 提供 了 配套 的 在 线 资源 ， 网 址 为 ituring.cn/book/2784， 其 中 包含 大 量 有 用 的 信息 ， 比 如 
如 何 设置 系统 以 及 如 何 解决 每 章 可 能 遇 到 的 难题 。 如 果 你 还 没有 查看 这 些 资源 ,现在 就 去 吧 , 看 
看 它们 能 和 否 提供 帮助 。 


C.2 ”在线 搜索 


很 可 能 有 人 遇 到 过 你 面临 的 问题 , 并 在 网 上 发 表 了 相关 的 文章 。 良 好 的 搜索 技能 和 具体 的 关 
键 词 有 助 于 找到 现 有 的 资源 ， 帮 助 解决 你 面临 的 问题 。 例 如 ， 如 果 无 法 在 Windows 10 系统 中 安 
装 最 新 版 Python， 搜 索 “Windows 10 安装 Python ) 并 将 结果 限定 为 一 年 内 ， 可 能 让 你 找到 清晰 
的 解决 方案 。 

使 用 计算 机 显示 的 错误 消息 进行 搜索 也 很 有 帮助 。 例 如 ， 假 设 你 试图 启动 Python 终端 会 话 
时 出 现 了 如 下 错误 消息 : 


> python 

'python' is not recognized as an internal or external command, 
operable program or batch file 

> 
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通过 搜索 完整 的 错误 消息 “python is not recognized as an internal or external command”， 也 许 
能 得 到 不 错 的 建议 。 

搜索 与 编程 相关 的 主题 时 ， 有 几 个 网 站 会 反复 出 现 。 下 面 简要 地 介绍 一 下 这 些 网 站 ,让 你 知 
道 它 们 可 能 提供 什么 样 的 帮助 。 


C.2.1 Stack Overflow 


Stack Overflow 是 最 受 程 序 员 欢迎 的 问答 网 站 之 一 ， 当 你 执行 与 Python 相关 的 搜索 时 ， 它 常 
常会 出 现在 第 一 个 结果 页 中 。Stack Overflow 的 成 员 在 陷入 困境 时 提出 问题 ， 其 他 成 员 会 努力 提 
供 有 帮助 的 答案 。 用 户 可 推荐 其 认为 最 有 帮助 的 答案 ， 因 此 前 几 个 答案 通常 就 是 最 佳 答案 。 

对 于 很 多 基本 的 Python 问题 , 在 Stack Overflow 上 有 非常 明确 的 答案 ,因为 这 个 社区 在 不 断 
改进 。 它 鼓励 用 户 发 布 更 新 的 帖子 ,因此 这 里 的 答案 通常 与 时 俱 进 。 本 书 编写 期 间 , Stack Overflow 
回答 的 与 Python 相关 的 问题 超过 了 一 百 万 个 。 


C.2.2 Python 官方 文档 


对 初学 者 来 说 ，Python 官方 文档 显得 有 点 漫不经心 ， 因 为 其 主要 目的 是 阐述 这 门 语言 ， 而 不 
是 进行 解释 。 官 方 文档 中 的 示例 应 该 很 有 用 , 但 你 也 许 不 能 完全 弄 懂 。 虽 然 如 此 ,这 还 是 一 个 不 
错 的 资源 ， 如 果 它 出 现在 搜索 结果 中 ， 就 值得 你 去 参考 ; 另外 ， 随 着 你 对 Python 的 认识 越 来 越 
深入 ， 这 个 资源 的 用 处 将 越 来 越 大 。 


C.2.3 库 官 方 文档 


如 果 你 使 用 了 库 ， 如 Pygame 、Matplotlib 和 Django 等 ， 搜 索 结 果 中 通常 会 包含 到 其 官方 文 
档 的 链接 。 例 如 ，Django 文档 就 很 有 用 。 如 果 你 要 使 用 这 些 库 ， 最 好 熟悉 其 官方 文档 。 


C.2.4 r/learnpython 


Reddit 包含 很 多 子 论坛 , 这 些 子 论坛 称 为 subreddit, 其 中 的 t/learnpython 非常 活跃 ,提供 的 
信息 也 很 有 帮助 。 你 可 以 在 这 里 阅读 其 他 人 提出 的 问题 ， 也 可 以 提出 自己 的 问题 。 


C.2.5 博客 

很 多 程序 员 有 博客 ， 旨 在 与 他 人 分 享 对 自己 所 使 用 语言 的 心得 。 接 受 博客 文章 提供 的 建议 
前 ， 应 大 致 浏览 一 下 前 几 条 评论 ， 看 看 别人 的 反馈 。 如 果 文 章 没有 任何 评论 ， 请 对 其 持 保留 态 
度 _ ”可 能 还 没有 人 验证 过 其 中 的 建议 。 
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C.3 IRC 


很 多 程序 员 通 过 IRC ( Internet Relay Chat, 互联 网 中 继 聊 天 ) 实时 交流 。 如 果 你 被 问题 困 住 ， 
在 网 上 搜索 也 找 不 到 答案 ， 那 么 在 相关 的 IRC 频道 ( channel ) 中 寻求 帮助 可 能 是 最 佳 选 择 。 这 
些 频道 里 的 人 大 多 彬 彬 有 礼 、 乐 于 助人 , 在 你 能 够 详细 地 描述 要 做 什么 、 尝 试 了 哪些 方法 及 其 结 
果 时 尤其 如 此 。 


Python 主 频 道 是 #python。 频 道 #earnpython ( 两 个 并 号 ) 也 非常 活跃 。 这 个 频道 与 Wlearnpython/ 
相关 联 ， 因 此 你 在 其 中 也 将 看 到 有 关 learnpython 上 帖子 的 消息 。 如 果 你 正在 开发 Web 应 用 程序 ， 
可 能 想 加 入 频道 #django。 加 入 频道 后 ， 就 可 以 看 到 其 他 人 的 交流 ， 还 可 以 提出 问题 。 


要 获得 有 效 的 帮助 , 你 需要 知道 一 些 有 关 IC 文化 的 细节 。 将 重点 放 在 本 附录 开头 所 说 的 三 
个 问题 上 , 无疑 有 助 于 获得 可 行 的 解决 方案 。 如 果 能 准确 地 阐述 你 要 做 什么 、 和 尝试 了 哪些 方法 以 
及 得 到 的 结果 , 别人 就 会 乐意 伸 出 援手 。 为 分 享 代码 或 输出 , IRC 成 员 会 使 用 外 部 网 站 , 如 bPaste 
( #python 通过 它 来 分 享 代码 和 输出 )。 这 能 避免 让 频道 到 处 都 是 代码 ， 还 让 分 享 的 代码 阅读 起 来 
容易 得 多 。 一 定 要 有 了 耐心， 这 样 别 人 才 会 更 乐意 帮助 你 。 准 确 地 提出 问题 ， 并 等 待 别人 来 回答 。 
虽然 大 家 都 在 忙于 交流 , 但 总 会 有 人 及 时 回答 你 的 问题 。 如 果 频 道 的 参与 者 较 少 , 可 能 要 过 一 段 
时 间 才 会 有 人 回答 你 的 问题 。 


C.4 Slack 


Slack 有 点 像 现代 版 IRC， 通 常用 于 公司 内 部 交流 ， 但 也 有 很 多 面向 公众 的 讨论 组 。 要 查看 
Slack Python 讨论 组 ， 可 访问 PySlackers 网 站 ， 单 击 页 面 顶 部 的 链接 Slack， 再 输入 电子 邮箱 地 址 
以 获取 邀请 郧 。 进 入 Python Developers 区 后 ， 将 看 到 一 个 频道 列表 ， 你 可 单 击 Channels 并 选择 
感 兴趣 的 主题 。 首 先 应 加 入 的 可 能 是 频道 机 earning_python 和 #django。 


C.5 Discord 


Discord 也 是 一 个 在 线 聊 天 环境 。 它 包含 一 个 Python 社区 ， 你 可 以 在 其 中 寻求 帮助 ， 还 可 以 
参加 与 Python 相关 的 讨论 。 要 进入 该 社区 ， 可 访问 Python Discord 网 站 ， 再 单 击 页 面 右 上 角 的 
DISCORD logo。 在 出 现 的 屏幕 中 ， 有 一 个 自动 生成 的 邀请 函 。 如 果 有 Discord 账户 ， 可 使 用 它 登 
录 ; 如 果 没 有 ， 请 输入 用 户 名 并 按 提示 完成 Discord 注册 过 程 。 首 次 访问 Python Discord 时 ， 需 
要 接受 社区 行为 准则 才能 参与 其 中 。 完 成 注册 并 登录 后 ， 就 能 加 入 任何 感 兴趣 的 频道 了 。 寻 求 帮 
助 时 ， 务 必 在 Python Help 频道 发 帖 。 


使 用 Git 进行 版 本 控制 


版 本 控制 软件 让 你 能 够 拍摄 处 于 可 行 状态 的 项 目 快 照 。 修 改 项 目 
( 如 实现 新 功能 ) 后 ， 如 果 项 目 不 能 正常 运行 ， 可 恢复 到 前 一 个 可 行 
状态 。 


通过 使 用 版 本 控制 软件 ， 你 可 以 放手 去 改进 项 目 ， 不 用 担心 项 目 因 你 犯错 而 遭 到 破坏 。 对 
大 型 项 目 来 说 ， 这 显得 尤其 重要 ,但 对 于 较 小 的 项 目 ， 哪 怕 是 只 包含 一 个 文件 的 程序 ， 这 也 大 
有 神 益 。 


在 本 附录 中 ， 你 将 学 习 如 何 安装 Git， 以 及 如 何 使 用 它 来 对 当前 开发 的 程序 进行 版 本 控制 。 
Git 是 当前 最 流行 的 版 本 控制 软件 ， 包 含 很 多 高 级 工具 ， 可 帮助 团队 协作 开发 大 型 项 目 ， 但 其 最 
基本 的 功能 也 非常 适合 独立 开发 人 员 使 用 。Git 通过 跟踪 对 项 目 中 每 个 文件 的 修改 来 实现 版 本 控 
制 ， 如 果 你 犯 了 错 ， 只 需 恢复 到 保存 的 前 一 个 状态 即 可 。 


D.1 安装 Git 


Git 可 在 所 有 操作 系统 上 运行 ， 但 安装 方法 随 操 作 系 统 而 异 。 接 下 来 的 几 小 节 详 细 说 明了 如 
何在 各 种 操作 系统 中 安装 它 。 
D.1.1 Windows 系统 


可 从 Git 网 站 下 载 Git 安装 程序 。 在 这 个 网 站 中 ， 你 将 看 到 下 载 链接 ， 指 向 适合 你 的 系统 的 
安装 程序 。 
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D.1.2 macOsS 系统 


macOS 系统 可 能 已 经 安装 了 Git， 因 此 请 尝试 执行 命令 git --version。 如 果 在 输出 中 看 到 了 


的 说 明 做 即 可 。 


具体 的 版 本 号 , 说 明 系统 安 装 了 Git; 如 曙 


看 到 一 条 消息 ， 提 示 你 安装 或 升级 Git， 只 需 按 屏幕 上 


你 也 可 以 访问 Git 网 站 主页 ， 将 看 到 下 载 链接 ， 指 向 适合 你 系统 的 安装 程序 。 


D.1.3 Linux 系统 


要 在 Linux 系统 中 安装 Git， 请 执行 如 下 命令 : 


$ sudo apt install git-all 


这 就 行 了 。 现 在 可 以 在 项 目 中 使 用 Git 了 。 


D.1.4 配置 Git 


Git 跟 踪 是 谁 修改 了 项 目 ， 哪 性 


参与 项 目 开 发 的 人 


只 有 一 个 。 为 此 ，Git 需 要 知道 你 的 用 户 名 


和 电子 邮箱 地 址 。 你 必须 提供 用 户 名 ,但 可 使 用 虚构 的 电子 邮箱 地 址 : 


$ git config --global user.name "Wsername" 
$ git config --global user.email "wsername@example.con 


如 果 你 忘记 了 这 一 步 ， 在 首次 提交 时 Git 将 提示 你 提供 这 些 信息 。 


D.2 创建 项 目 


我 们 来 创建 一 个 要 进行 版 本 控制 的 项 目 。 在 系统 中 创建 一 个 文件 夹 ， 并 将 其 命名 为 


git_practice。 在 这 个 文件 夹 中 ,创建 一 个 简 


的 Python 程序 : 


hello gitpy print("Hello Git world!") 


我 们 将 使 用 这 个 程序 来 探索 Git 的 基本 功能 。 


D.3 ”忽略 文件 


扩展 名 为 .pyc 的 文件 是 根据 .py 文件 自动 生成 的 , 因此 无 须 让 Git 跟踪 它们 。 这 些 文件 存储 在 
目录 _pycache_ 中。 为 了 让 Git 忽略 这 个 目录 , 创建 一 个 名 为 .gitignore 的 特殊 文件 (这 个 文件 名 
以 句点 打头 且 没 有 扩展 名 )， 并 在 其 中 添加 下 面 一 行内 容 : 


-gitignore _ pycache / 
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这 让 Git 忽 略 目 录 _pycache _ 中 的 所 有 文件 。 使 用 文件 .gitignore 可 避免 项 目 混乱 , 让 其 开发 
你 可 能 需要 修改 文本 编辑 器 的 设置 , 使 其 显示 隐藏 的 文件 , 这 样 才能 使 用 它 来 打开 文件 .gitignore。 
有 些 编辑 器 被 设置 成 忽略 名 称 以 句点 打头 的 文件 。 


D.4 初始 化 仓库 


前 面 创建 了 一 个 目录 ， 其 中 包含 一 个 Python 文件 和 一 个 .gitignore 文件 ， 现 在 可 以 初始 化 一 
个 Git 仓 库 了 。 为 此 ， 打 开 一 个 终端 窗口 ， 切 换 到 文件 夹 git_practice， 并 执行 如 下 命令 : 


git practice$ git init 
Initialized empty Git repository in git practice/.git/ 
git practice$ 


输出 表明 Git 在 git_practice 中 初始 化 了 一 个 空仓 库 。 仓 库 是 程序 中 被 Git 主动 跟踪 的 一 组 文 
件 。Git 用 来 管理 仓库 的 文件 都 存储 在 隐藏 的 目录 .git 中 ,你 根本 不 需要 与 这 个 目录 打交道 , 但 千 
万 不 要 删除 它 ， 和 否则 将 丢失 项 目的 所 有 历史 记录 。 


D.5 检查 状态 
执行 其 他 操作 前 ， 先 来 看 一 下 项 目的 状态 : 


git practice$ git status 
@ On branch master 


No commits yet 


@ Untracked files: 
(use "git add <file>..." to include in what will be committed) 


.gitignore 
hello git.py 


@ nothing added to commit but untracked files present (use "git add" to track) 
git practice$ 


在 Git 中 ,分 支 是 项 目的 一 个 版 本 。 从 这 里 的 输出 可 知 ， 我 们 位 于 分 支 master 上 ( 见 @ )。 
你 每 次 查看 项 目的 状态 时 ， 输 出 都 将 指出 位 于 分 支 master 上 。 接 下 来 的 输出 表明 还 未 执行 任何 
提交 。 提 交 是 项 目 在 特定 时 点 的 快照 。 

Git 指出 了 项 目 中 未 被 跟踪 的 文件 ( 见 @ )， 因 为 我 们 还 没有 告诉 它 要 跟踪 哪些 文件 。 接 下 
来 ,Git 告诉 我 们 尚未 将 任何 东西 添加 到 当前 提交 中 , 但 指出 了 可 能 需要 加 入 仓库 中 的 未 跟踪 文 
件 ( 见 @ )。 


附录 D 使 用 Git 进行 版 本 控制 439 


D.6 将 文件 加 入 仓库 中 
下 面 将 这 两 个 文件 加 入 仓库 中 ， 并 再 次 检查 状态 


@ git practice$ git add . 
@ git practice$ git status 
On branch master 


No commits yet 


Changes to be committed: 
(use "git rm --cached <file>..." to unstage) 
©@ new file: .gitignore 
new file: hello git.py 


git practice$ 


命令 git add .将 项 目 中 未 被 跟踪 的 所 有 文件 都 加 入 仓库 中 ( 见 @ )。 它 不 提交 这 些 文件 ， 只 是 
让 Git 开始 关注 它们 。 现 在 检查 项 目的 状态 时 ， 我 们 发 现 Git 找 出 了 需要 提交 的 一 些 修改 ( 见 @ )。 
标签 new file 意味 着 这 些 文件 是 新 添加 到 仓库 中 的 ( 见 @ )。 


D.7 执行 提交 
下 面 来 执行 第 一 次 提交 


@ git practice$ git commit -m "Started project." 
@ [master (root-commit) ee76419] Started project. 
@ 2 files changed, 4 insertions(+) 

create mode 100644 .gitignore 

create mode 100644 hello git.py 
@ git practice$ git status 

On branch master 

nothing to commit, working tree clean 

git practice$ 


我 们 执行 命令 git commit -m "message" ( 见 @ ) 拍摄 项 目的 快照 。 标 志 -m 让 Git 将 接 下 来 的 
消息 ("Started project." ) 记录 到 项 目的 历史 记录 中 。 输 出 表明 位 于 分 文 master 上 ( 见 @ )， 
且 有 两 个 文件 被 修改 了 ( 见 @ )。 


现在 检查 状态 时 ， 会 发 现 我 们 位 于 分 支 master 上 ， 且 工作 树 是 干净 的 〈 见 @ )。 这 是 你 每 次 
提交 项 目的 可 行 状 态 时 都 希望 看 到 的 消息 。 如 果 显 示 的 消息 不 是 这 样 的 ， 请 仔细 阅读 ， 很 可 能 是 
你 在 提交 前 忘记 了 添加 文件 。 
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D.8 查看 提交 历史 
Git 记 录 所 有 的 项 目 提交 。 下 面 来 看 一 下 提交 历史 


git practice$ git log 

commit a9d74d87f1aa3b8f5b2688cb586eacia908cfc7f (HEAD -> master) 
Author: Eric Matthes <eric@example.com> 

Date: Mon Jan 21 21:24:28 2019 -0900 


Started project. 
git practice$ 


每 次 提交 时 ，Git 都 会 生成 唯一 的 引用 ID， 长 40 字符 。 它 记录 提交 是 谁 执行 的 、 提 交 的 时 
间 以 及 提交 时 指定 的 消息 。 并 非 在 任何 情况 下 都 需要 所 有 这 些 信息 ， 因 此 Git 提供 了 一 个 选项 ， 
让 你 能 够 打印 提交 历史 条 目的 更 简单 版 本 : 


git practice$ git log --pretty=oneline 
ee76419954379819f3f2cacafd15103ea900ecb2 (HEAD -> master) Started project. 
git practice$ 


标志 --pretty=oneline 指定 显示 两 项 最 重要 的 信息 : 提交 的 引用 ID 和 为 提交 记录 的 消息 。 
D.9 第 二 次 提交 


为 展示 版 本 控制 的 强大 威力 ， 我 们 需要 修改 项 目 并 提交 所 做 的 修改 。 为 此 ,在 hello_gitpy 
中 再 添加 一 行 代码 : 


hello gitpy print("Hello Git world!") 
print("Hello everyone.") 


如 果 现 在 查看 项 目的 状态 ， 将 发 现 Git 注意 到 这 个 文件 发 生 了 变化 : 


git practice$ git status 
@ On branch master 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


@ modified: hello git.py 


©@ no changes added to commit (use "git add" and/or "git commit -a") 
git practice$ 


输出 指出 了 当前 所 在 的 分 六 ( 见 @ ) 和 被 修改 了 的 文件 的 名 称 ( 见 @ )， 还 指出 了 所 做 的 修 
改 未 提交 ( 见 @ )。 下 面 来 提交 所 做 的 修改 ， 并 再 次 查看 状态 : 
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@ git practice$ git commit -am "Extended greeting." 
[master 51fofe5] Extended greeting. 
1 file changed, 1 insertion(+), 1 deletion(-) 
@ git practice$ git status 

On branch master 
nothing to commit, working tree clean 
@ git practice$ git log --pretty=oneline 
51fofe5884e045b91c12c5449fabf4adoeef8e5d (HEAD -> master) Extended greeting. 
ee76419954379819f3f2cacafd15103ea900ecb2 Started project. 


git practice 


我 们 再 次 执行 了 提交 ， 并 在 执行 命令 git commit 时 指定 了 标志 -am ( 见 @ )。 标志 -a 让 Git 
将 仓库 中 所 有 修改 了 的 文件 都 加 入 当前 提交 中 。( 如 果 在 两 次 提交 之 间 创 建 了 新 文件 ， 可 再 次 执 
行 命令 git add .， 将 这 些 新 文件 加 入 仓库 中 。 ) 标志 -m 让 Git 在 提交 历史 中 记录 一 条 消息 。 


查看 项 目的 状态 时 ， 我 们 发 现 工作 树 也 是 干净 的 ( 见 @ )。 最 后 ， 可 以 看 到 提交 历史 中 包含 
两 个 提交 ( 见 @ )。 


D.10 撤销 修改 


下 面 来 看 看 如 何 放弃 所 做 的 修改 ， 恢 复 到 前 一 个 可 行 状 态 。 为 此 ， 首 先 在 hello_gitpy 中 再 
添加 一 行 代码 : 


hello gitpy print("Hello Git world!") 
print("Hello everyone.") 


print("Oh no, I broke the project!") 


保存 并 运行 这 个 文件 。 
我 们 查看 状态 ， 发 现 Git 注意 到 了 所 做 的 修改 : 


git practice$ git status 
On branch master 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


© modified: hello git.py 


no changes added to commit (use "git add" and/or "git commit -a") 
git practice$ 


Git 注意 到 我 们 修改 了 hello_git.py ( 见 @ )。 如 果 愿 意 ， 可 提交 所 做 的 修改 ,但 这 次 我 们 不 提 
交 所 做 的 修改 ， 而 是 恢复 到 最 后 一 个 提交 ( 我 们 知道 ， 那 次 提交 时 项 目 能 够 正常 地 运行 )。 为 此 ， 
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不 对 hello_git.py 执行 任何 操作 〈 不 删除 刚 添 加 的 代码 行 ， 也 不 使 用 文本 编辑 器 的 撤销 功能 )， 而 
是 在 终端 会 话 中 执行 如 下 命令 : 


git practice$ git checkout . 

git practice$ git status 

On branch master 

nothing to commit, working tree clean 
git practice$ 


命令 git checkout 让 你 能 够 恢复 到 以 前 的 任意 提交 。 命 令 git checkout .放弃 最 后 一 次 提交 
后 所 做 的 所 有 修改 ， 将 项 目 恢复 到 最 后 一 次 提交 的 状态 。 


如 果 此 时 返回 文本 编辑 器 ， 将 发 现 hello_git.py 被 修改 成 了 下 面 这 样 : 


print("Hello Git world!") 
print("Hello everyone.") 


就 这 个 项 目 而 言 , 恢复 到 前 一 个 状态 微不足道 , 但 如 果 我 们 开发 的 是 大 型 项 目 ， 其 中 数 十 个 
文件 都 被 修改 了 ,那么 恢复 到 前 一 个 状态 ,将 撤销 自 最 后 一 次 提交 后 对 这 些 文件 所 做 的 所 有 修改 。 
这 个 功能 很 有 用 : 实现 新 功能 时 ,你 可 以 根据 需要 做 任意 数量 的 修改 ,如 果 这 些 修改 不 可 行 ， 可 
撤销 它们 , 而 不 会 对 项 目 有 任何 伤害 。 你 无 须 记 住 做 了 哪些 修改 , 因而 不 必 手 工 撤销 所 做 的 修改 ， 
Git 会 蔡 你 完成 所 有 这 些 工作 。 


注意 要 看 到 以 前 的 版 本 ， 可 能 需要 在 编辑 器 中 刷新 文件 。 


D.11 检 出 以 前 的 提交 


你 可 以 检 出 提交 历史 中 的 任何 提交 ， 而 不 仅仅 是 最 后 一 次 提交 ， 为 此 可 在 命令 git check 末 
尾 指定 该 提交 的 引用 了 D 的 前 6 字符 ( 而 不 是 句点 ) 通过 检 出 以 前 的 提交 , 你 可 以 对 其 进行 审核 ， 
然后 返回 到 最 后 一 次 提交 ， 或 者 放弃 最 近 所 做 的 工作 并 选择 以 前 的 提交 : 


git practice$ git log --pretty=oneline 
51fofe5884e045b91c12c5449fabf4adoeef8e5d (HEAD -> master) Extended greeting. 
ee76419954379819f3f2cacafd15103ea900ecb2 Started project. 

git practice$ git checkout ee7641 

Note: checking out 'ee7641'. 


@ You are in 'detached HEAD' state. You can look around, make experimental 
changes and commit them, and you can discard any commits you make in this 
state without impacting any branches by performing another checkout. 


If you want to create a new branch to retain commits you create, you may 
do so (now or later) by using -b with the checkout command again. Example: 
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git checkout -b <new-branch-name> 


HEAD is now at ee7641... Started project. 
git practice$ 


仿 出 以 前 的 提交 后 ， 将 离开 分 支 master， 进 入 Git 所 说 的 分 离 头 指针 ( detached HEAD ) 状 
态 ( 见 @ )。HEAD 指针 表示 当前 提交 的 项 目 状态 ， 之 所 以 说 处 于 分 离 状 态 ， 是 因为 我 们 离开 了 
一 个 命名 分 支 (这 里 是 master )。 


要 回 到 分 支 master， 可 检 出 它 : 


git practice$ git checkout master 

Previous HEAD position was ee76419 Started project. 
Switched to branch “masteT 

git practice$ 


这 让 你 回 到 分 支 master。 除 非 要 使 用 Git 的 高 级 功能 ， 否 则 在 检 出 以 前 的 提交 之 后 ， 最 好 不 
要 对 项 目 做 任何 修改 。 然 而 ,如 果 参 与 项 目 开 发 的 人 只 有 你 自己 ,而 你 又 想 放弃 较 近 的 所 有 提交 
并 恢复 到 以 前 的 状态 ， 也 可 将 项 目 重 置 到 以 前 的 提交 。 为 此 ， 可 在 处 于 分 支 master 上 的 情况 下 ， 
执行 如 下 命令 : 


@ git practice$ git status 

On branch master 
nothing to commit, working directory clean 
@ git practice$ git log --pretty=oneline 
51fofe5884e045b91c12c5449fabf4adoeef8e5d (HEAD -> master) Extended greeting. 
ee76419954379819f3f2cacafd15103ea900ecb2 Started project. 
@ git practice$ git reset --hard ee76419 
HEAD is now at ee76419 Started project. 
@ git practice$ git status 

On branch master 
nothing to commit, working directory clean 
©@ git practice$ git log --pretty=oneline 
ee76419954379819f3f2cacafd15103ea900ecb2 (HEAD -> master) Started project. 
git practice 


首先 查看 状态 ， 确 认 位 于 分 支 master 上 ( 见 @ )。 查 看 提交 历史 时 ,我们 看 到 了 两 个 提交 
( 见 @ )。 接 下 来 ， 执 行 命令 git reset --hard， 并 在 其 中 指定 要 永久 恢复 到 的 提交 的 引用 攻 前 6 
字符 ( 见 @ ),。 我 们 再 次 查看 状态 ,发现 位 于 分 支 master 上 ， 且 没有 需要 提交 的 修改 ( 见 @ )。 再 
次 查看 提交 历史 时 ， 会 发 现 我 们 回 到 了 要 重新 开始 的 提交 ( 见 @ )。 


D.12 删除 仓库 


有 时 候 , 仓库 的 历史 记录 被 你 弄 乱 了 ， 而 你 又 不 知道 如 何 恢复 。 在 这 种 情况 下 ,你 首先 应 考 
上 处 使 用 附录 C 介绍 的 方法 寻求 帮助 。 如 果 无 法 恢复 且 参 与 项 目 开 发 的 只 有 你 一 个 人 , 可 继续 使 用 
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[ba 


这 些 文件 ， 但 要 将 项 目的 历史 记录 删除 


删除 目录 .git。 这 不 会 影响 任何 文件 的 当前 状态 ， 只 


会 删除 所 有 的 提交 ， 因 此 你 将 无 法 检 出 项 目的 其 他 任何 状态 。 


为 此 ， 可 打开 一 个 文件 浏览 器 ， 并 将 目录 .git 删除 ， 也 可 通过 命令 行将 其 删除 。 这 样 做 后 ， 
需要 重新 创建 一 个 仓库 ， 重 新 对 修改 进行 跟踪 。 下 面 演示 了 如 何在 终端 会 话 中 完成 这 个 过 程 : 
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ce$ git status 

ot a git repository (or any of the parent directories): .git 
ce$ git init 

zed empty Git repository in git practice/.git/ 

ice$ git status 

h master 


ts yet 


d files: 
git add <file>..." to include in what will be committed) 


nore 
git.py 


added to commit but untracked files present (use "git add" to track) 


© git practice$ git add . 


git prac 
[master 
2 files 
create 
create 


tice$ git commit -m "Starting over." 
(root-commit) 6baf231] Starting over. 
changed, 4 insertions(+) 

mode 100644 .gitignore 

mode 100644 hello git.py 


@ git practice$ git status 


On branc 


h master 


nothing to commit, working tree clean 
git practice$ 


首先 查看 状态 ， 发 现 工作 树 是 干净 的 ( 见 @ )。 接 下 来 ， 使 用 命令 rm -rf .git (在 Windows 
系统 中 ， 应 使 用 命令 rmdir /s .git ) 删除 目录 .git ( 见 @ )。 删 除 文件 夹 .git 后 再 次 查看 状态 时 ， 
我 们 被 告知 这 不 是 一 个 Git 仓 库 ( 见 @ )。Git 用 来 跟踪 仓库 的 信息 都 存储 在 文件 夹 .git 中 , 因此 删 
除 该 文件 夹 也 将 删除 整个 仓库 。 


接 下 来 ， 


使 用 命令 git init 新 建 一 个 全 新 的 仓库 〈 见 @ )。 然 后 查看 状态 ， 发 现 又 回 到 了 初 


始 状 态 ， 等 待 着 第 一 次 提交 ( 见 @ )。 我 们 将 所 有 文件 都 加 入 仓库 ， 并 执行 第 一 次 提交 ( 见 @ )。 


然后 再 次 查看 状态 ， 发 现 我 们 位 于 新 的 分 支 master 上 ， 且 没有 任何 未 提交 的 修改 ( 见 @ )。 
你 需要 经 过 一 定 的 练习 才能 学 会 使 用 版 本 控制 ， 但 一 旦 开始 使 用 ， 你 就 再 也 离 不 开 它 了 。 


后 记 


祝贺 你 ! 你 学 习 了 Python 基本 知识 ， 并 利用 这 些 知识 创建 了 一 些 有 意义 的 项 目 : 创建 了 一 
款 游戏 ， 对 一 些 数 据 进行 了 可 视 化 ， 还 创建 了 一 个 Web 应 用 程序 。 现 在 ， 你 能 通过 众多 不 同 的 
方式 进一步 提高 编程 技能 了 。 

首先 ,应 该 根据 自己 的 兴趣 继续 开发 有 意义 的 项 目 。 当 你 通过 编程 来 解决 重要 的 相关 问题 时 ， 
编程 将 更 具 吸 引力 ,而 且 现 在 你 具备 了 开发 各 种 项 目 所 需 的 技能 。 你 可 以 开发 自己 的 游戏 , 也 可 
以 开发 模仿 经 典 街 机 游戏 的 游戏 。 你 可 能 想 研 究 一 些 对 你 来 说 很 重要 的 数据 , 并 通过 可 视 化 方法 
将 其 中 有 趣 的 规律 和 关系 展示 出 来 。 你 可 以 创建 自己 的 Web 应 用 程序 ， 也 可 以 尝试 模拟 自己 喜 
欢 的 应 用 程序 。 

只 要 有 机 会 ， 就 邀请 别人 尝试 你 编写 的 程序 吧 。 如 果 你 编写 了 游戏 ， 就 邀请 别人 来 玩 一 玩 ; 
如 果 你 创建 了 图 表 ， 就 向 别人 展示 展示 ， 看 看 他 们 能 否 看 明白 ; 如 果 你 创建 了 Web 应 用 程序 ， 
就 将 其 部 署 到 在 线 服 务 器 , 并 邀请 别人 尝试 使 用 。 听 上 听 用 户 怎么 说 , 并 努力 根据 他 们 的 反馈 改进 
项 目 ， 这 样 你 就 能 成 为 更 优秀 的 程序 员 。 

自己 动手 开发 项 目 时 ,你 肯定 会 遇 到 环 手 乃至 无 法 解决 的 问题 。 请 想 办 法 寻求 帮助 ， 并 加 入 
合适 的 Python 社区。 加 入 当地 的 Python 用 户 组 , 或 者 到 一 些 在 线 Python 社区 和 逛 逛 就 很 不 错 。 另 
外 ， 考 虑 参加 附近 举办 的 Python 开发 者 大 会 (PyCon )。 


你 应 尽力 在 开发 自己 感 兴趣 的 项 目 和 提高 Python 技能 之 间 取 得 平衡 。 网 上 有 很 多 Python 学 
习 资 料 ， 市 面 上 还 有 大 量 针 对 中 级 程序 员 编写 的 Python 图 书 。 现 在 你 掌握 了 基本 知识 ， 并 且 知 
道 了 如 何 应 用 学 到 的 技能 ， 因 此 能 看 懂 其 中 的 很 多 资料 。 通 过 阅读 教程 和 图 书 积累 更 多 的 知识 ， 
加 深 你 对 编程 和 和 Python 的 认识 吧 。 深 入 学 习 Python 后 再 去 开发 项 目 时 ， 你 将 能 够 更 高 效 地 解决 
更 多 的 问题 。 


祝贺 你 在 学 习 Python 的 道路 上 走 了 这 人 么 远 ， 愿 你 在 以 后 的 学 习 中 有 好 运 相伴 


版 权 声 明 


Copyright © 2019 by Eric Matthes. Python Crash Course, 2nd Edition : A Hands-On, Project-Based 
Introduction to Programming, ISBN 978-1-59327-928-8, published by No Starch Press. Simplified 
Chinese-language edition copyright © 2020 by Posts and Telecom Press. All rights reserved. 


No part of this book may be reproduced or transmitted in any form or by any means, electronic or 
mechanical, including photocopying, recording, or by any information storage or retrieval system, 
without the prior written permission of the copyright owner and the publisher. 

本 书 中 文 简体 字 版 由 No Starch Press 授权 人 民 邮 电 出 版 社 独家 出 版 。 未 经 出 版 者 书面 许可 ， 
不 得 以 任何 方式 复制 或 抄袭 本 书 内 容 。 

版 权 所 有 ， 侵 权 必 完 。 


回复 “Python” 查 看 相关 书 单 


© 


微 博 连接 
关注 @ 图 灵 教 育 每 日 分 享 上 IT 好 书 


全 


QQ 连接 


图 灵 读 者 官方 群 [， 218139230 
图 灵 读 者 官方 群 I[: 164939616 


图 灵 社 区 
iTuring.cn 
在 线 出 版 , 电子 书 ,《 码 农 》 杂志, 图 灵 访 谈 


中 文 版 重印 30 余 次 ， 销量 近 750 000 册 
针对 Python 3 新 特性 升级 ， 重 写 项 目 代码 
真正 零 基础 ， 自 学 也 轻松 


“我 想 阅 ，Python 是 否 值得 学 ， 已 经 不 再 是 值得 怀疑 的 问题 了 。 但 是 ， 如 何 能 高 效 学 会 Python ， 永 远 
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更 准确 地 描述 了 Python 语 言 的 细节 。 

第 二 部 分 “项 目 ” 采 用 更 简明 的 结构 、 更 清晰 的 语法 以 及 更 流行 的 库 和 工具 ， 如 Plotly 和 新 版 本 
的 Django。 


本 书 还 附带 丰富 的 学 习 资 源 ， 包 括 源 代 码 文件 、 练 习 答 案 和 配套 视频 等 ， 助 读者 零 压 力 成 为 优秀 的 
Python 程序 员 ! 
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